JUnit 5 Release Notes

Field and method search algorithms now adhere to standard Java semantics regarding whether a given field or method is visible or overridden according to the rules of the Java language. See the new Field and Method Search Semantics section of the User Guide for details.

ReflectionSupport.findFields(…​) now returns a distinct set of fields.

Fixed parsing of recursive jar URIs which allows the JUnit Platform Launcher to be used inside Spring Boot executable jars for Spring Boot 3.2 and later.

The junit-platform-suite-engine now includes configuration provided via @ConfigurationParameter when selecting tests by UniqueId.

In order to support using @EnabledInNativeImage on test classes, UniqueIdTrackingListener now tracks descendants of skipped test containers.

As mentioned in the Bug Fixes section above, field and method search algorithms now adhere to standard Java semantics regarding whether a given field or method is visible or overridden according to the rules of the Java language. The changes in the search algorithms may, however, result in breaking changes for some use cases. In light of that, it is possible to revert to the previous "legacy semantics". See the new Field and Method Search Semantics section of the User Guide for details.

New ConversionSupport utility in junit-platform-commons which exposes the conversion logic that was previously private to JUnit Jupiter’s @ParameterizedTest infrastructure — for use in third-party extensions and test engines.

Error messages for type mismatches in NamespacedHierarchicalStore now include the actual type and value in addition to the required type.

Due to changes in the JUnit Platform regarding field and method search algorithms (see Bug Fixes above), numerous bugs have been addressed within JUnit Jupiter, including but not limited to the following.

TempDir suppresses NoSuchFileException when deleting files that may have been deleted by another thread or process.

Kotlin support now depends on Kotlin API and language version 1.6; whereas, it previously depended on version 1.3.

New @FieldSource annotation for use with @ParameterizedTest methods which allows you to source arguments from a local field or an external field referenced by fully qualified field name. This feature is similar to the existing @MethodSource feature. See the User Guide for details.

New @AutoClose annotation that can be applied to fields within tests to automatically close the annotated resource after test execution. See the User Guide for details.

JAVA_23 has been added to the JRE enum for use with JRE-based execution conditions.

Improved documentation for semantics of a disabled test regarding class-level lifecycle methods and callbacks.

❓

❓

❓

The junit-platform-launcher may now be used as a Java module when junit.platform.launcher.interceptors.enabled is set to true.

Field predicates are no longer applied eagerly while searching the type hierarchy.

Method predicates are no longer applied eagerly while searching the type hierarchy.

JUnit Jupiter once again properly detects when a @Test method is overridden in a subclass.

A package-private static field annotated with @TempDir is once again shadowed by a non-static field annotated with @TempDir when the non-static field resides in a different package and has the same name as the static field.

A package-private class-level lifecycle method annotated with @BeforeAll or @AfterAll is once again shadowed by a method-level lifecycle method annotated with @BeforeEach or @AfterEach when the method-level lifecycle method resides in a different package and has the same name as the class-level lifecycle method.

Field predicates are now applied while searching the type hierarchy. This fixes bugs in findFields(…​) and streamFields(…​) in ReflectionSupport as well as findAnnotatedFields(…​) and findAnnotatedFieldValues(…​) in AnnotationSupport.

Method predicates are now applied while searching the type hierarchy. This fixes bugs in findMethods(…​) and streamMethods(…​) in ReflectionSupport as well as findAnnotatedMethods(…​) in AnnotationSupport.

A package-private static field annotated with @TempDir is no longer shadowed by a non-static field annotated with @TempDir when the non-static field resides in a different package and has the same name as the static field.

A package-private class-level lifecycle method annotated with @BeforeAll or @AfterAll is no longer shadowed by a method-level lifecycle method annotated with @BeforeEach or @AfterEach when the method-level lifecycle method resides in a different package and has the same name as the class-level lifecycle method.

The ON_SUCCESS cleanup mode of @TempDir now takes into account failures of test methods and nested tests when it’s declared on the class level, e.g. as a static field.

The RandomNumberExtension example in the User Guide has been updated to properly support Integer types as well as non-static field injection.

Improved Javadoc for Assertions.assertTimeoutPreemptively regarding thread interrupt.

Documentation for @Disabled and conditional annotations now explicitly explains that such annotations are not inherited by subclasses.

Fixed reporting for JUnit 3 test classes that use JUnit 4’s @Ignored annotation.