TestExecutionExceptionHandler (JUnit 5.2.0-RC1 API)

All Superinterfaces:

Extension

All Known Implementing Classes:

ExpectedExceptionSupport

Functional Interface:

This is a functional interface and can therefore be used as the assignment target for a lambda expression or method reference.
```
@FunctionalInterface
@API(status=STABLE,
     since="5.0")
public interface TestExecutionExceptionHandler
extends Extension
```
TestExecutionExceptionHandler defines the API for Extensions that wish to handle exceptions thrown during test execution.
In this context, test execution refers to the physical invocation of a @Test method and not to any test-level extensions or callbacks.
Common use cases include swallowing an exception if it's anticipated or rolling back a transaction in certain error scenarios.
Implementations must provide a no-args constructor.

Since:

5.0

Method Summary

All Methods Instance Methods Abstract Methods
Modifier and Type	Method	Description
`void`	`handleTestExecutionException(ExtensionContext context, Throwable throwable)`	Handle the supplied `throwable`.

- Method Detail
  - handleTestExecutionException
```
void handleTestExecutionException(ExtensionContext context,
                                  Throwable throwable)
                           throws Throwable
```
    Handle the supplied throwable.
    Implementors must perform one of the following.
    
    Swallow the supplied throwable, thereby preventing propagation.
    
    Rethrow the supplied throwable as is.
    
    Throw a new exception, potentially wrapping the supplied throwable.
    
    If the supplied throwable is swallowed, subsequent TestExecutionExceptionHandlers will not be invoked; otherwise, the next registered TestExecutionExceptionHandler (if there is one) will be invoked with any Throwable thrown by this handler.
    Note that the execution exception in the supplied ExtensionContext will not contain the Throwable thrown during invocation of the corresponding @Test method.
    Parameters:
    
    context - the current extension context; never null
    
    throwable - the Throwable to handle; never null
    
    Throws:
    
    Throwable