JUnit 5 Release Notes

Fix support for disabling ANSI colors on the console when the NO_COLOR environment variable is available.

❓

New addResourceContainerSelectorResolver() in EngineDiscoveryRequestResolver.Builder to support the discovery of class path resource based tests, analogous to the addClassContainerSelectorResolver().

Introduce ReflectionSupport.makeAccessible(Field) for third-party use rather than calling the internal ReflectionUtils.makeAccessible(Field) method directly.

Support both the primitive type void and the wrapper type Void in the internal ReflectionUtils to allow String to Class conversion in parameterized tests.

Add support for passing line and column number to ConsoleLauncher via --select-file and --select-resource.

ConsoleLauncher now accepts multiple values for all --select options.

Add --select-unique-id support to ConsoleLauncher.

The following improvements have been made to the open-test-reporting XML output:

❓

When injecting TestInfo into test class constructors it now contains data of the test method the test class instance is being created for unless the test instance lifecycle is set to PER_CLASS (in which case it continues to contain the data of the test class). If you require the TestInfo of the test class, you can implement a class-level lifecycle method (e.g., @BeforeAll) and inject TestInfo into that method.

When injecting TestReporter into test class constructors the published report entries are now associated with the test method rather than the test class unless the test instance lifecycle is set to PER_CLASS (in which case they will continue to be associated with the test class). If you want to publish report entries for the test class, you can implement a class-level lifecycle method (e.g., @BeforeAll) and inject TestReporter into that method.

New --exclude-methodname and --include-methodname options added to the ConsoleLauncher to include or exclude methods based on fully qualified method names without parameters. For example, --exclude-methodname=^org\.example\..+#methodname will exclude all methods called methodName under package org.example.

In a @ParameterizedTest method, a null value can now be supplied for Java Date/Time types such as LocalDate if the new nullable attribute in @JavaTimeConversionPattern is set to true.

ArgumentsProvider (declared via @ArgumentsSource), ArgumentConverter (declared via @ConvertWith), and ArgumentsAggregator (declared via @AggregateWith) implementations can now use constructor injection from registered ParameterResolver extensions.

Extensions based on TestTemplateInvocationContextProvider can now allow returning zero invocation contexts by overriding the new mayReturnZeroTestTemplateInvocationContexts method.

The new @ParameterizedTest(requireArguments = false) attribute allows to specify that the absence of arguments is expected in some cases and should not cause a test failure.

Allow determining "shared resources" at runtime via the new @ResourceLock#providers attribute that accepts implementations of ResourceLocksProvider.

Extensions that implement TestInstancePreConstructCallback, TestInstanceFactory, TestInstancePostProcessor, ParameterResolver, or InvocationInterceptor may override the getTestInstantiationExtensionContextScope() method to enable receiving a test-scoped ExtensionContext in Extension methods called during test class instantiation. This behavior will become the default in future versions of JUnit.

@TempDir is now supported on test class constructors.

Parameterized tests now support argument count validation. If the junit.jupiter.params.argumentCountValidation=strict configuration parameter or the @ParameterizedTest(argumentCountValidation = STRICT) attribute is set, any mismatch between the declared number of arguments and the number of arguments provided by the arguments source will result in an error. By default, it’s still only an error if there are fewer arguments provided than declared.

The new PreInterruptCallback extension point defines the API for Extensions that wish to be called prior to invocations of Thread#interrupt() by the @Timeout extension.

When enabled via the junit.jupiter.execution.timeout.threaddump.enabled configuration parameter, an implementation of PreInterruptCallback is registered that writes a thread dump to System.out prior to interrupting a test thread due to a timeout.

❓

❓

❓

Fixed a regression in method search algorithms introduced in 5.11.0 when classes reside in the default package and using a Java 8 runtime.

Extensions can once again be registered via multiple @ExtendWith meta-annotations on the same composed annotation on a field within a test class.

@ExtendWith annotations can now also be repeated when used directly on fields and parameters.

All @…​Source annotations of parameterized tests can now also be repeated when used as meta annotations.

Fix regression in parallel execution that was introduced in 5.10.4/5.11.1 regarding global read-write locks. When such a lock was declared on descendants of top-level nodes in the test tree, such as Cucumber scenarios, test execution failed.

Fix support for disabling ANSI colors on the console when the NO_COLOR environment variable is available.

NamespacedHierarchicalStore no longer throws an exception after it has been closed if the store is queried via one of the get(…​) or getOrComputeIfAbsent(…​) methods; however, if a getOrComputeIfAbsent(…​) invocation results in the computation of a new value, an exception will still be thrown.

Fixed potential locking issue with ExclusiveResource in the HierarchicalTestExecutorService, which could lead to deadlocks in certain scenarios.

Improve parallelism and reduce number of blocked threads used by HierarchicalTestEngine implementations when parallel execution is enabled and the global read-write lock is used.

TestWatcher callback methods can once again access data in the ExtensionContext.Store.

Improve parallelism and reduce number of blocked threads in the presence of @Isolated tests when parallel execution is enabled