Why Testing multiple exceptions in JUnit? - Purpose & Use Cases

The Big Idea

What if you could catch all your program's error problems with just one smart test?

The Scenario

Imagine you have a program that can fail in many ways, like a vending machine that might run out of coins, get stuck, or have no snacks left. You try to check each problem by running the machine and watching carefully for errors.

The Problem

Manually testing each error means repeating many steps over and over. It's slow and easy to miss some errors. You might forget to check one problem or mix up the results. This makes fixing bugs harder and wastes time.

The Solution

Testing multiple exceptions lets you write one test that checks many error cases at once. It catches all the problems quickly and clearly. This saves time and helps you trust your program works well even when things go wrong.

Before vs After

✗ Before

try {
  methodThatMightThrow();
  fail("Expected exception");
} catch (FirstException e) {
  // test passed
}
try {
  methodThatMightThrow();
  fail("Expected exception");
} catch (SecondException e) {
  // test passed
}

✓ After

@Test
void testMultipleExceptions() {
  assertAll(
    () -> assertThrows(FirstException.class, () -> methodThatThrowsFirst()),
    () -> assertThrows(SecondException.class, () -> methodThatThrowsSecond())
  );
}

What It Enables

You can quickly check many error cases in one place, making your tests clearer and your code safer.

Real Life Example

Think of a bank app that must handle errors like "insufficient funds" or "account locked". Testing multiple exceptions ensures all these problems are caught before customers see them.

Key Takeaways

Manual error checks are slow and easy to miss.

Testing multiple exceptions groups error tests neatly.

This approach saves time and improves test clarity.

Practice

1.

Which JUnit method is best to test that a specific exception is thrown by a method?

easy

A. assertThrows()

B. assertEquals()

C. assertTrue()

D. assertNull()

Solution

1. Step 1: Understand the purpose of assertThrows()

   This method checks if a specific exception is thrown when running a code block.

2. Step 2: Compare with other assertion methods

   assertEquals() checks values, assertTrue() checks boolean conditions, and assertNull() checks for null values, none test exceptions.

3. Final Answer:

   assertThrows() -> Option A

4. Quick Check:

   Test exceptions with assertThrows() [OK]

Hint: Use assertThrows() to check exceptions directly [OK]

Common Mistakes:

• Using assertEquals() to test exceptions
• Trying to catch exceptions manually in tests
• Confusing assertTrue() with exception testing

2.

Which of the following is the correct syntax to test that IllegalArgumentException is thrown by myMethod() in JUnit 5?

?

easy

A. assertThrows(myMethod(), IllegalArgumentException.class);

B. assertThrows(() -> myMethod(), IllegalArgumentException.class);

C. assertThrows(IllegalArgumentException.class, () -> myMethod());

D. assertThrows(IllegalArgumentException, myMethod());

Solution

1. Step 1: Recall assertThrows() method signature

   The correct order is the exception class first, then a lambda with the code to test.

2. Step 2: Check each option's syntax

   assertThrows(IllegalArgumentException.class, () -> myMethod()); matches the correct syntax: assertThrows(Exception.class, () -> method());. Others have wrong order or missing lambda.

3. Final Answer:

   assertThrows(IllegalArgumentException.class, () -> myMethod()); -> Option C

4. Quick Check:

   Exception class first, then lambda [OK]

Hint: Exception class first, then lambda expression [OK]

Common Mistakes:

• Swapping parameters order in assertThrows
• Not using a lambda expression
• Passing method call instead of lambda

3.

Given the following JUnit 5 test code, what will be the test result?

void testMultipleExceptions() {
  assertThrows(NullPointerException.class, () -> { throw new NullPointerException(); });
  assertThrows(IllegalStateException.class, () -> { throw new IllegalArgumentException(); });
}

medium

A. Test fails because second assertThrows expects IllegalStateException but gets IllegalArgumentException

B. Test passes because both exceptions are thrown

C. Test fails because NullPointerException is not thrown

D. Test passes because assertThrows ignores exception type

Solution

1. Step 1: Analyze first assertThrows

   It expects NullPointerException and throws NullPointerException, so it passes.

2. Step 2: Analyze second assertThrows

   It expects IllegalStateException but throws IllegalArgumentException, so it fails.

3. Final Answer:

   Test fails because second assertThrows expects IllegalStateException but gets IllegalArgumentException -> Option A

4. Quick Check:

   Expected exception must match thrown exception [OK]

Hint: Exception types must match exactly in assertThrows [OK]

Common Mistakes:

• Assuming any exception passes assertThrows
• Ignoring mismatch in exception types
• Thinking assertThrows catches all exceptions

4.

Identify the error in the following JUnit 5 test code that tries to test two exceptions:

@Test
void testExceptions() {
  assertThrows(NullPointerException.class, () -> method1());
  assertThrows(IllegalArgumentException.class, () -> method2());
  assertThrows(IllegalStateException.class, () -> method3());
}

Assuming method2() throws IllegalStateException instead of IllegalArgumentException.

medium

A. The test will pass because all exceptions are thrown

B. The second assertThrows will fail because expected and actual exceptions differ

C. The test will fail because assertThrows cannot be called multiple times

D. The test will fail because method3() is not called

Solution

1. Step 1: Check expected vs actual exceptions for method2()

   Expected is IllegalArgumentException but actual thrown is IllegalStateException, so assertThrows fails.

2. Step 2: Confirm other assertThrows calls

   Calls for method1() and method3() are correct or irrelevant to this error.

3. Final Answer:

   The second assertThrows will fail because expected and actual exceptions differ -> Option B

4. Quick Check:

   Expected exception must match thrown exception [OK]

Hint: Check expected vs actual exception types carefully [OK]

Common Mistakes:

• Assuming multiple assertThrows calls cause failure
• Ignoring mismatch in exception types
• Thinking assertThrows tests method calls, not exceptions

5.

You want to test that a method process() throws either IOException or TimeoutException depending on conditions. Which is the best way to write JUnit 5 tests for both exceptions?

hard

A. Use one assertThrows with both exceptions listed together

B. Use assertThrows only for the first exception and ignore the second

C. Catch exceptions manually inside one test and assert their types

D. Write two separate tests each using assertThrows for one exception

Solution

1. Step 1: Understand assertThrows usage

   assertThrows tests one exception type per call; it cannot test multiple exceptions at once.

2. Step 2: Best practice for multiple exceptions

   Write separate tests for each expected exception to keep tests clear and focused.

3. Final Answer:

   Write two separate tests each using assertThrows for one exception -> Option D

4. Quick Check:

   One assertThrows per exception per test [OK]

Hint: Test each exception in its own assertThrows call [OK]

Common Mistakes:

• Trying to test multiple exceptions in one assertThrows
• Catching exceptions manually instead of using assertThrows
• Ignoring one exception in tests