JUnit 5 Release Notes

A custom ClassLoader created for additional --class-path entries passed to the ConsoleLauncher will now be closed after usage to gracefully free file handles.

The internal PreconditionViolationException class in concealed package org.junit.platform.commons.util is now deprecated and has been replaced by an exception class with the same name in exported package org.junit.platform.commons.

AnnotationSupport.findRepeatableAnnotations() now finds repeatable annotations used as meta-annotations on other repeatable annotations.

New AnnotationSupport.findRepeatableAnnotations() variant that accepts a java.util.Optional<? extends AnnotatedElement> argument.

Exceptions thrown by TestExecutionListeners no longer cause test execution to abort. Instead, they will be logged as warnings now.

New MethodSource.from() variant that accepts String, String, Class<?>…​ as arguments.

Execution of dynamic tests registered via a @TestFactory method no longer results in an OutOfMemoryError if the executables in the dynamic tests retain references to objects consuming large amounts of memory. Technically speaking, JUnit Jupiter no longer retains references to instances of DynamicTest after they have been executed.

Script-based condition APIs and their supporting implementations are deprecated with the intent to remove them in JUnit Jupiter 5.6. Users should instead rely on a combination of other built-in conditions or create and use a custom implementation of ExecutionCondition to evaluate the same conditions.

Support for declarative timeouts using @Timeout or configuration parameters (see User Guide for details)

New overloaded variants of Assertions.assertLinesMatch(…​) that accept a String or a Supplier<String> for a custom failure message.

Failure messages for Assertions.assertLinesMatch(…​) now emit each expected and actual line in a dedicated line.

New Kotlin friendly assertDoesNotThrow, assertTimeout, and assertTimeoutPreemptively assertions have been added as top-level functions in the org.junit.jupiter.api package.

New emptyValue attribute in @CsvSource and @CsvFileSource.

Display names for test methods generated by the ReplaceUnderscores DisplayNameGenerator no longer include empty parentheses for test methods that do not declare any parameters.

New junit.jupiter.displayname.generator.default configuration parameter to set the default DisplayNameGenerator that will be used unless @DisplayName or @DisplayNameGeneration is present.

MethodOrderer.Random now generates a default random seed only once and prints it to the log in order to allow reproducible builds.

Methods ordered with MethodOrderer.Random now execute using the SAME_THREAD concurrency mode instead of the CONCURRENT mode when no custom seed is provided.

The declared field type for an extension registered via @RegisterExtension is no longer required to implement an Extension API. It is now sufficient if the extension implementation can be assigned to the declared field type. This provides extension authors greater flexibility as well as the ability to hide implementation details of the user facing extension API.

Private fields annotated with @RegisterExtension are no longer silently ignored. Instead the corresponding test class or test method will now fail with an exception informing the user of the configuration error.

All methods in the TestWatcher API are now interface default methods with empty implementations.

New InvocationInterceptor extension API (see User Guide for details).

New LifecycleMethodExecutionExceptionHandler extension API for handling exceptions thrown during the execution of @BeforeAll, @BeforeEach, @AfterEach, and @AfterAll lifecycle methods (see User Guide for details).

A custom test source for a DynamicContainer or DynamicTest may now be a method URI — for example, method:org.example.MyTestClass#myTestMethod().

New junit.jupiter.execution.parallel.mode.classes.default configuration parameter allows to run top-level classes in parallel but their methods sequentially or vice versa (see User Guide for details).

junit:junit is now a compile-scoped dependency of junit-vintage-engine to allow for easier dependency management in Maven POMs.

A method that is public is now preferred over other methods with the same name in the same test class when creating a MethodSource for a JUnit 4 Description.

Configurable test discovery implementation that can be reused by different test engines (see Javadoc of the org.junit.platform.engine.support.discovery package).

New isFinal() and isNotFinal() methods in ModifierSupport.

Expected and actual values are now supplied for failed boolean assertions for enhanced IDE and reporting support — for example, when assertTrue() or assertFalse() fails.

@ValueSource now additionally supports literal values of type boolean for parameterized tests.

Parameterized tests no longer throw an ArrayStoreException when creating human-readable test names.

Safeguard against Runners that only report tests as failed but not as started or finished such as Spock in case of failures during data-provider preparation.

Restore compatibility with Android: Unsupported Pattern flags, like UNICODE_CHARACTER_CLASS, no longer cause class StringUtils to fail during initialization.

Deletion of a temporary directory within a test no longer results in a test failure for a temporary directory supplied via @TempDir.

Fix reporting of finish events of intermediate containers with static and dynamic children, e.g. Spock test classes with regular and @Unroll feature methods in a test suite.