JUnit 5 Release Notes

TestPlan.add(TestIdentifier) has always been considered internal and is now deprecated. While calls from third-party code will continue to work for the time being, IDEs and build tools should remove any such code as soon as possible.

The Launcher API now provides an execute(TestPlan, TestExecutionListener…​) method that allows one to execute a previously discovered TestPlan.

@RunWith(JUnitPlatform.class) no longer executes test discovery twice.

The root cause and suppressed exceptions are now included in the stack trace printed by the ConsoleLauncher.

The ConsoleLauncher now sanitizes user-provided display names before printing them to the console.

AnnotationSupport provides new methods for finding annotated fields and their values.

ReflectionSupport provides new methods for finding fields and reading a field’s value.

Additional overloaded variants of the assertEquals() und assertNotEquals() methods in Assertions that solve Groovy method dispatch problems caused by overloaded variants introduced in 5.4 M1.

@RegisterExtension fields that are null when evaluated are no longer silently ignored. Instead, the corresponding test class or test method now fails with an informative exception.

@ParameterizedTest once again supports MessageFormat patterns for individual parameters — for example, {0,number,#.##}.

The ParentDirProvider strategy in the TempDirectory extension introduced in 5.4 M1 now accepts a TempDirContext instead of ParameterContext.

@TempDir (introduced in 5.4 M1) is no longer supported on constructor parameters. Please use field injection instead.

Extensions registered programmatically via @RegisterExtension may now be registered in an explicit order via the @Order annotation.

New @NullSource, @EmptySource, and @NullAndEmptySource argument sources that provide null and empty arguments to @ParameterizedTest methods.

New TestWatcher extension API that allows extensions to process test results by defining result-based callbacks invoked after text execution.

The TempDirectory extension now supports parameters of type File in addition to Path, and @TempDir may now be applied to static or non-static fields.

The VintageTestEngine now uses the fully qualified class name as the legacy reporting name for Vintage test classes instead of the simple class name which caused problems in test reports based on legacy reporting names — for example, reports generated by Maven Surefire.

The VintageTestEngine now validates that the version of junit:junit on the classpath is supported (i.e., is equal to or greater than 4.12).

The junit-platform-suite-api artifact no longer has an unnecessary direct dependency on junit-platform-commons.

Containers and tests that interrupt the current thread no longer cause surprising failures in subsequent tests that interact with the reused thread.

The JUnit Platform Maven Surefire Provider (junit-platform-surefire-provider) has been discontinued and is no longer released as part of JUnit 5. Please use Maven Surefire’s native support for running tests on the JUnit Platform instead (requires Maven Surefire 2.22.0 or higher).

New junit-platform-reporting artifact containing a LegacyXmlReportGeneratingListener that generates XML reports using a format which is compatible with the de facto standard for JUnit 4 based test reports that was made popular by the Ant build system.

New junit-platform-testkit artifact containing a Test Kit API for testing the execution of a TestEngine running on the JUnit Platform.

New ModifierSupport class providing an API for extension and test engine authors to inspect modifiers of classes and members.

Exceptions reported due to failed reflective operations such as loading a class, reading a field’s value, or looking up a method by name now include the original exception as their cause to make it easier to debug underlying issues.

Implementations of HierarchicalTestEngine may now add behavior that wraps around the invocation of Node.before(), Node.execute(), and Node.after() using the new Node.around() hook.

@ResourceLock can now be declared on test template methods such as @RepeatedTest and @ParameterizedTest methods. If @ResourceLock is used, the invocations will run in the same thread, even if parallel execution is enabled.

The default mode for parallel test execution has been changed from CONCURRENT to SAME_THREAD to allow for gradual opt-in by using the @Execution annotation on individual test classes or methods. You can invert this behavior by changing the default execution mode via the new junit.jupiter.execution.parallel.mode.default configuration parameter. Please refer to the User Guide for details.

New org.junit.jupiter:junit-jupiter artifact that simplifies dependency management for JUnit Jupiter in build tools such as Gradle and Maven.

Assertions.assertEquals() variants that compare floating point numbers using a delta now support a delta of zero.

New Assertions.assertEquals() variants that accept mixed boxed and unboxed primitive values, allowing statements such as assertEquals(42, Integer.valueOf("42")) to compile.

New Assertions.assertNotEquals() variants that accept the following primitive data types: char, byte, short, int, long, float, and double. Mixed boxed and unboxed primitive values are also supported.

Exceptions thrown in Assertions.assertAll() are now additionally tracked as suppressed exceptions in the resulting MultipleFailuresError. Consequently, the stack traces for such exceptions are now visible as Suppressed at the end of the stack trace for the invocation of assertAll().

JUnit 4’s AssumptionViolatedException is now supported in JUnit Jupiter for aborting a test mid-flight due to a failed assumption — for example, via JUnit 4’s org.junit.Assume utility class.

New TempDirectory extension (formerly part of JUnit Pioneer) that allows one to write test that require a temporary directory in a java.nio.file.FileSystem.

New JRE.JAVA_12 enum constant for use with @EnabledOnJre and @DisabledOnJre.

In addition to returning streams, @TestFactory-annotated methods may now return a single DynamicNode — for example, a DynamicTest or a DynamicContainer.

Implicit conversion from hexadecimal and octal string representations to integral types in @ParameterizedTest arguments — for example, conversion from "0xff" to 255.

New LOCALE and TIME_ZONE constants in org.junit.jupiter.api.parallel.Resources for use with @ResourceLock to synchronize test execution regarding the default Locale and default TimeZone, respectively.

New MethodOrderer API for ordering the sequence of tests with built-in support for alphanumeric, @Order annotation based, and random ordering of test methods.

New DisplayNameGenerator interface and @DisplayNameGeneration annotation that allow declarative configuration of a pre-defined or custom display name generator.

JUnit 4’s @Ignore annotation is now supported for disabling test classes and test methods via the junit-jupiter-migrationsupport module.

New ExtensionContext methods to access all test instances, including enclosing ones for @Nested tests: getTestInstances() and getRequiredTestInstances().

When configured with --details verbose, the ConsoleLauncher no longer throws a MissingFormatArgumentException if a test method display name contains String format specifiers such as %c.

Assertions.assertAll() is now thread-safe — for example, it can now be used with a parallel Stream.

The OS.SOLARIS enum constant used with @EnabledOnOs and @DisabledOnOs is now also detected as the current operating system if the os.name JVM system property contains "SunOs".

Assertions.assertLinesMatch() no longer throws a NullPointerException after evaluating a fast-forward match if there are more expected lines after the fast-forward match than remain in the actual results. This bug only manifested itself if the expected list size was equal to or greater than the actual list size.

Multidimensional arrays may now be supplied to @ParameterizedTest methods from factory methods configured via @MethodSource.

Threads created for running tests in parallel now use the same thread context class loader (TCCL) that was set when creating the underlying executor service. This resolves ClassNotFoundException issues that only occur in parallel execution mode when a custom TCCL is in place.

When executing tests in parallel, lifecycle methods and callbacks called after a @TestFactory method are now always executed after the dynamic tests returned by the method.

Exceptions thrown during initialization of static @RegisterExtension fields now cause the test class to fail instead of being silently swallowed.

An OutOfMemoryError regression introduced in JUnit 5.3.0 has been fixed.

The OpenTest4J dependency has been updated to 1.1.1 to fix a serialization incompatibility between 1.0.0 and 1.1.0 that caused failure messages to be discarded when used from Gradle and potentially other tools and IDEs.

Invocations of assertThrows() that are passed a method reference for an overloaded method with a void return type once again compile.

In order to revert the aforementioned breaking change, variants of assertThrows() introduced in JUnit 5.3.0 that accept ThrowingSupplier arguments have been removed.