public @Interface ParameterizedTest

See ParameterizedInvocationConstants#ARGUMENT_SET_NAME_OR_ARGUMENTS_WITH_NAMES_PLACEHOLDER.

See ParameterizedInvocationConstants#ARGUMENT_SET_NAME_PLACEHOLDER.

See ParameterizedInvocationConstants#ARGUMENTS_PLACEHOLDER.

See ParameterizedInvocationConstants#ARGUMENTS_WITH_NAMES_PLACEHOLDER.

See ParameterizedInvocationConstants#DEFAULT_DISPLAY_NAME.

See ParameterizedInvocationConstants#DISPLAY_NAME_PLACEHOLDER.

See ParameterizedInvocationConstants#INDEX_PLACEHOLDER.

Configure whether zero invocations are allowed for this parameterized test.

Set this attribute to true if the absence of invocations is expected in some cases and should not cause a test failure.

Defaults to false.

Annotations

@API

status:MAINTAINED

since:5.13.3

Since

5.12

Configure how the number of arguments provided by an ArgumentsSource are validated.

Defaults to ArgumentCountValidationMode#DEFAULT.

When an ArgumentsSource provides more arguments than declared by the parameterized test method, there might be a bug in the method or the ArgumentsSource. By default, the additional arguments are ignored. argumentCountValidation allows you to control how additional arguments are handled. The default can be configured via the junit.jupiter.params.argumentCountValidation configuration parameter (see the User Guide for details on configuration parameters).

Annotations

@API

status:MAINTAINED

since:5.13.3

Since

5.12

See Also

ArgumentCountValidationMode

Configure whether all arguments of the parameterized test that implement AutoCloseable will be closed after their corresponding invocation.

Defaults to true.

Annotations

@API

status:STABLE

since:5.10

Since

5.8

See Also

java.lang.AutoCloseable

The display name to be used for individual invocations of the parameterized test; never blank or consisting solely of whitespace.

Defaults to {default_display_name}.

If the default display name flag ({default_display_name}) is not overridden, JUnit will:

• Look up the junit.jupiter.params.displayname.default configuration parameter and use it if available. The configuration parameter can be supplied via the Launcher API, build tools (e.g., Gradle and Maven), a JVM system property, or the JUnit Platform configuration file (i.e., a file named junit-platform.properties in the root of the class path). Consult the User Guide for further information.
• Otherwise, [{index}] {argumentSetNameOrArgumentsWithNames} will be used.

Supported placeholders

• {displayName}
• {index}
• {argumentSetName}
• {arguments}
• {argumentsWithNames}
• {argumentSetNameOrArgumentsWithNames}
• "{0}", "{1}", etc.: an individual argument (0-based)

For the latter, you may use java.text.MessageFormat patterns to customize formatting (for example, {0,number,#.###}). Please note that the original arguments are passed when formatting, regardless of any implicit or explicit argument conversions.

Note that {default_display_name} is a flag rather than a placeholder.

See Also

java.text.MessageFormat, quoteTextArguments()

Configure whether to enclose text-based argument values in quotes within display names.

Defaults to true.

In this context, any CharSequence (such as a String) or Character is considered text. A CharSequence is wrapped in double quotes ("), and a Character is wrapped in single quotes (').

Special characters in Java strings and characters will be escaped in the quoted text — for example, carriage returns and line feeds will be escaped as \\r and \\n, respectively. In addition, any ISO control character will be represented as a question mark (?) in the quoted text.

For example, given a string argument "line 1\nline 2", the representation in the display name would be "\"line 1\\nline 2\"" (printed as "line 1\nline 2") with the newline character escaped as "\\n". Similarly, given a string argument "\t", the representation in the display name would be "\"\\t\"" (printed as "\t") instead of a blank string or invisible tab character. The same applies for a character argument '\t', whose representation in the display name would be "'\\t'" (printed as '\t').

Please note that original source arguments are quoted when generating a display name, before any implicit or explicit argument conversion is performed. For example, if a parameterized test accepts 3.14 as a float argument that was converted from "3.14" as an input string, "3.14" will be present in the display name instead of 3.14.

Annotations

@API

status:EXPERIMENTAL

since:6.0

Since

6.0

See Also

name()