JUnit 5 Release Notes

Fixed handling of global post-discovery filters that apply to @Suite classes.

Since the Turkish language has special characters such as 'ı' and 'İ', the uppercase conversion in DefaultParallelExecutionConfigurationStrategy#getStrategy previously caused all tests to finish with exit code -1. This has been fixed by using the root locale instead of the default one.

ConfigurationParameters.size() has been deprecated in favor of the new keySet() method.

Support for the Open Test Reporting format which supports all features of the JUnit Platform such as hierarchical test structures, display names, tags, etc. Please refer to the User Guide for instructions on how to enable such reports in your build.

ConfigurationParameters has a new keySet() method which allows you to retrieve all configuration parameter keys.

New IterationSelector for selecting a subset of a test’s or container’s iterations.

ParallelExecutionConfiguration allows configuring the saturate predicate of the ForkJoinPool used for parallel test execution.

JUnit OSGi bundles now contain engine and launcher requirements ensuring that at resolution time a fully running set of dependencies is calculated, avoiding the need for these to be manually specified.

JUnit Platform Standalone Console JAR now also includes the JUnit Platform Suite Engine.

New failIfNoTests attribute added to @Suite. This will fail the suite if no tests are discovered.

The output color for the ConsoleLauncher can now be customized. The option --single-color will apply a built-in monochrome style, while --color-palette will accept a properties file. See the User Guide for details.

The default theme for the ConsoleLauncher is now determined by the charset reported by the system console on Java 17 and later.

New --list-engines option added to the ConsoleLauncher which displays all registered test engine implementations.

Configuring included EngineFilters that do not match any registered TestEngine results in an error to avoid misconfiguration – for example, due to typos.

When cleaning up a @TempDir, only one retry attempt will be made to delete directories.

Since the Turkish language has special characters such as 'ı' and 'İ', the uppercase conversion in DefaultParallelExecutionConfigurationStrategy#getStrategy previously caused all tests to finish with exit code -1. This has been fixed by using the root locale instead of the default one.

@TempDir fields are no longer allowed to be declared as final.

@TempDir now includes a cleanup mode attribute for preventing a temporary directory from being deleted after a test. The default cleanup mode can be configured via a configuration parameter.

Support for FreeBSD and OpenBSD operating systems in @EnabledOnOs and @DisabledOnOs.

New MATCH_NONE mode for @EnumSource that selects only those enum constants whose names match none of the supplied patterns.

The @Order annotation is now a STABLE API.

New TestInstancePreConstructCallback extension API that is called prior to test instance construction – symmetric to the existing TestInstancePreDestroyCallback extension API.

Extensions can now leverage registered ParameterResolver extensions when invoking methods and constructors via the new ExecutableInvoker API available in the ExtensionContext.

A subset of the invocations of parameterized or dynamic tests can now be selected via the new IterationSelector discovery selector when launching the JUnit Platform.

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

@MethodSource factory methods can now accept arguments resolved by registered ParameterResolver extensions.

Text blocks in @CsvSource are now treated like complete CSV files, including support for comments beginning with a # symbol as well as support for new lines within quoted strings. See the User Guide for details and examples.

CSV headers can now be used in display names in parameterized tests. See @CsvSource and @CsvFileSource in the User Guide for details and examples.

The quote character for quoted strings in @CsvSource and @CsvFileSource is now configurable via a new quoteCharacter attribute in each annotation.

@UseTechnicalNames has been deprecated in favor of the new @Suite support which does not require the use of technical names. See the warning in Using JUnit 4 to run the JUnit Platform for details.

ReflectionSupport.findNestedClasses(..) is now thread-safe with regard to cycle detection.

assertLinesMatch() in Assertions no longer fails with a NoSuchElementException if a limited fast-forward followed by at least one more expected line exceeds the remaining actual lines.

assertLinesMatch() in Assertions now handles fast-forwards with leading and trailing spaces correctly and no longer throws an IndexOutOfBoundsException.

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

CSV content in @CsvSource can now be supplied as a text block instead of an array of strings. See the User Guide for details and an example.

The ExecutionMode for the current test or container is now accessible via the ExtensionContext.

Relaxed version constraint in published Gradle Module Metadata to allow downgrading the junit:junit dependency from 4.13.2.