Testing Mastery: JUnit, Mockito & Integration Tests · Lesson

Exception Testing & Timeouts

Verify expected exceptions and implement timeouts to prevent infinite loops or long-running test cases.

Exception Testing & Timeouts is a free Testing Mastery: JUnit, Mockito & Integration Tests lesson on CoddyKit — lesson 3 of 4. You can read the complete lesson below for free — then practise it hands-on in the browser with a built-in code editor and a 24/7 AI tutor. It is part of the Testing Mastery: JUnit, Mockito & Integration Tests learning path, one of 4 lessons in the course, and your progress syncs across the web and the CoddyKit app.

Test for Expected Errors

Sometimes, your code is designed to throw an error under specific, invalid conditions. For example, dividing by zero. Exception testing ensures that your code handles these situations correctly.

It validates both the success and failure paths.
It confirms your error messages are accurate.

Catching Exceptions with JUnit

JUnit 5 provides the assertThrows method to verify that a specific exception is thrown. This is the recommended and cleanest way to test for expected exceptions.

It takes the expected exception type (e.g., IllegalArgumentException.class).
It takes a lambda expression (a small piece of code) that should trigger the exception.

`assertThrows` in Action

Let's see assertThrows in a simple test. Our Calculator method divide should throw an IllegalArgumentException if the divisor is zero.

import org.junit.jupiter.api.Test;
import static org.junit.jupiter.api.Assertions.*;

class Calculator {
    public int divide(int a, int b) {
        if (b == 0) {
            throw new IllegalArgumentException("Divisor cannot be zero");
        }
        return a / b;
    }
}

public class ExceptionTest {
    @Test
    void testDivideByZeroThrowsException() {
        Calculator calc = new Calculator();
        assertThrows(IllegalArgumentException.class, () -> {
            calc.divide(10, 0);
        });
    }
}

Checking Exception Details

It's often not enough to just know *that* an exception was thrown. You might also want to verify its details, like the exception message or other properties.

The assertThrows method returns the actual exception object, allowing you to perform further assertions on it.

Asserting Exception Message

Here, we capture the exception object returned by assertThrows and then use assertEquals to verify its message. This makes your exception tests very precise.

import org.junit.jupiter.api.Test;
import static org.junit.jupiter.api.Assertions.*;

class Calculator {
    public int divide(int a, int b) {
        if (b == 0) {
            throw new IllegalArgumentException("Divisor cannot be zero");
        }
        return a / b;
    }
}

public class ExceptionMessageTest {
    @Test
    void testDivideByZeroMessage() {
        Calculator calc = new Calculator();
        IllegalArgumentException thrown = assertThrows(
            IllegalArgumentException.class,
            () -> calc.divide(10, 0),
            "Expected divide() to throw, but it didn't"
        );
        assertEquals("Divisor cannot be zero", thrown.getMessage());
    }
}

Preventing Endless Tests with Timeouts

Sometimes, a piece of code can get stuck in an infinite loop or take an unexpectedly long time to complete. This can cause your test suite to hang indefinitely.

Timeouts are a crucial feature that automatically fail a test if it exceeds a specified duration, ensuring your test suite runs efficiently.

Setting Timeouts with `@Timeout`

JUnit 5 uses the @Timeout annotation to set a maximum duration for test methods or entire test classes. You specify the maximum value and a unit of time.

Common units include TimeUnit.SECONDS, TimeUnit.MILLISECONDS, TimeUnit.MINUTES.
If the test runs longer than the specified time, it will fail.

Method-Level Timeout Example

Here's how to apply a timeout to a single test method. If the longRunningTask() takes more than 1 second, this test will automatically fail.

import org.junit.jupiter.api.Test;
import org.junit.jupiter.api.Timeout;
import java.util.concurrent.TimeUnit;
import static org.junit.jupiter.api.Assertions.*;

public class TimeoutMethodTest {

    // A method that might take too long
    private void longRunningTask() throws InterruptedException {
        Thread.sleep(1500); // Simulates a task taking 1.5 seconds
    }

    @Test
    @Timeout(value = 1, unit = TimeUnit.SECONDS)
    void testTaskShouldCompleteWithinOneSecond() throws InterruptedException {
        longRunningTask(); // This will cause the test to fail due to timeout
        assertTrue(true, "Task completed (but it will timeout)");
    }
}

Class-Level Timeouts

You can also apply the @Timeout annotation at the class level. When placed on a test class, all test methods within that class will inherit the specified timeout.

If a test method also has its own @Timeout annotation, the method-level timeout will override the class-level one for that specific method.

Test Your Knowledge

Which JUnit 5 feature is best suited to ensure a test method completes execution within a predefined time limit, failing if it exceeds that limit?

Recap: Exceptions & Timeouts

In this lesson, you learned to write robust tests for expected errors and to prevent runaway tests:

You used assertThrows to verify that specific exceptions are thrown by your code.
You learned how to verify specific details of an exception, such as its message.
You applied the @Timeout annotation to set time limits for your test methods and classes, ensuring efficient test execution.

Frequently asked questions

Is the “Exception Testing & Timeouts” lesson free?

Yes — the full text of “Exception Testing & Timeouts” is free to read here on the web, and the Testing Mastery: JUnit, Mockito & Integration Tests course includes 4 lessons in total. To practise it interactively (a built-in code editor and a 24/7 AI tutor) and unlock the rest of the Testing Mastery: JUnit, Mockito & Integration Tests course, upgrade to CoddyKit PRO.

What will I learn in “Exception Testing & Timeouts”?

Verify expected exceptions and implement timeouts to prevent infinite loops or long-running test cases. You practise Testing Mastery: JUnit, Mockito & Integration Tests with hands-on code you run directly in the browser, and a 24/7 AI tutor answers your questions as you work through the lesson.

Do I need any experience to start Testing Mastery: JUnit, Mockito & Integration Tests?

No prior experience is required. Testing Mastery: JUnit, Mockito & Integration Tests on CoddyKit is structured for beginners through advanced learners; this is — lesson 3 of 4, so you can start here or from the beginning and move at your own pace.

How long does the “Exception Testing & Timeouts” lesson take?

Most CoddyKit lessons take about 5–10 minutes. Each one is bite-sized and interactive, so you make steady progress and pick up exactly where you left off across the web and the app.

Can I write and run code in this Testing Mastery: JUnit, Mockito & Integration Tests lesson?

Yes. Every Testing Mastery: JUnit, Mockito & Integration Tests lesson includes a built-in code editor, so you write and run real code right in your browser and get instant AI feedback — no local setup required.

All lessons in this course

← Back to Testing Mastery: JUnit, Mockito & Integration Tests