assertTimeout for performance in JUnit - Test Execution Trace

Test Overview

This test checks if a method completes its execution within a specified time limit using assertTimeout in JUnit. It verifies the performance by ensuring the method does not exceed the allowed duration.

Test Code - JUnit 5

JUnit

import static org.junit.jupiter.api.Assertions.assertTimeout;
import java.time.Duration;
import org.junit.jupiter.api.Test;

public class PerformanceTest {

    public void performTask() {
        // Simulate a task that takes some time
        try {
            Thread.sleep(500); // 500 milliseconds
        } catch (InterruptedException e) {
            Thread.currentThread().interrupt();
        }
    }

    @Test
    public void testPerformTaskCompletesWithinOneSecond() {
        assertTimeout(Duration.ofSeconds(1), () -> {
            performTask();
        });
    }
}

Execution Trace - 7 Steps

Step	Action	System State	Assertion	Result
1	Test starts	JUnit test runner initialized	-	PASS
2	JUnit invokes testPerformTaskCompletesWithinOneSecond()	Test method ready to execute	-	PASS
3	assertTimeout starts timer with 1 second limit	Timer running to measure execution duration	-	PASS
4	performTask() method executes and sleeps for 500 milliseconds	Simulated task running	-	PASS
5	performTask() completes within 500 milliseconds	Task finished before timeout	Execution time <= 1 second	PASS
6	assertTimeout verifies execution time is within limit	Test method execution complete	assertTimeout passes	PASS
7	Test finishes successfully	JUnit reports test passed	-	PASS

Failure Scenario

Failing Condition: performTask() takes longer than 1 second to complete

Execution Trace Quiz - 3 Questions

What does assertTimeout verify in this test?

A The method returns the correct result

B The method throws an exception

C The method completes execution within the specified time limit

D The method runs on a separate thread

Key Result

Use assertTimeout in JUnit to ensure methods complete within expected time limits, helping catch performance regressions early.