Package org.junitpioneer.jupiter.params

Annotation Type DisableIfAnyArgument

@Target(METHOD)
@Retention(RUNTIME)
@ExtendWith(org.junitpioneer.jupiter.params.DisableIfArgumentExtension.class)
public @interface DisableIfAnyArgument

@DisableIfAnyArgument is a JUnit Jupiter extension that selectively disables a ParameterizedTest execution if at least one argument (as defined by Object.toString()) satisfies the specified condition.

The extension uses Jupiter's InvocationInterceptor. It's important to note that since it's marked as API.Status.EXPERIMENTAL it might be removed without prior notice. Unlike Disabled annotations, this extension doesn't disable the whole test method. With DisableIfAnyArgument, it is possible to selectively disable tests out of the plethora of dynamically registered parameterized tests.

The extension requires that exactly one of contains or matches is configured.

For more information how the extension resolves the annotations, check the documentation.

Since:

1.5.0

See Also:

• DisableIfArgumentExtension

Optional Element Summary

Optional Elements

Modifier and Type	Optional Element	Description
String[]	contains	Disable test cases if any argument (converted to String with Object.toString()) contains any of the the specified strings (according to String.contains(CharSequence)).
String[]	matches	Disable test cases if any argument (converted to String with Object.toString()) matches any of the specified regular expressions (according to String.matches(String)).

Element Details

contains

String[] contains

Disable test cases if any argument (converted to String with Object.toString()) contains any of the the specified strings (according to String.contains(CharSequence)).

Default:

{}

matches

String[] matches

Disable test cases if any argument (converted to String with Object.toString()) matches any of the specified regular expressions (according to String.matches(String)).

Default:

{}