org.junit.platform.suite.api

Annotation Type IncludeTags

@Retention(value=RUNTIME)
 @Target(value=TYPE)
 @Inherited
 @Documented
 @API(status=MAINTAINED,
     since="1.0")
public @interface IncludeTags

@IncludeTags specifies the tags or tag expressions to be included when running a test suite on the JUnit Platform.

Tag Expressions

Tag expressions are boolean expressions with the following allowed operators: ! (not), & (and) and | (or). Parentheses can be used to adjust for operator precedence. Please refer to the JUnit 5 User Guide for usage examples.

Syntax Rules for Tags

• A tag must not be blank.
• A trimmed tag must not contain whitespace.
• A trimmed tag must not contain ISO control characters.
• A trimmed tag must not contain reserved characters.

Reserved characters that are not permissible as part of a tag name.

• ","
• "("
• ")"
• "&"
• "|"
• "!"

JUnit 4 Suite Support

Test suites can be run on the JUnit Platform in a JUnit 4 environment via @RunWith(JUnitPlatform.class).

Since:

1.0

See Also:

SuiteDisplayName, UseTechnicalNames, SelectPackages, SelectClasses, IncludeClassNamePatterns, ExcludeClassNamePatterns, IncludePackages, ExcludePackages, ExcludeTags, IncludeEngines, ExcludeEngines, TagFilter.includeTags(java.lang.String...), JUnitPlatform

Required Element Summary

Required Elements

Modifier and Type	Required Element and Description
java.lang.String[]	value One or more tags to include.

Element Detail

value

public abstract java.lang.String[] value

One or more tags to include.

Note: each tag will be trimmed and validated according to the Syntax Rules for Tags (see class-level Javadoc for details).