Module org.junit.platform.suite.api
Package org.junit.platform.suite.api

Annotation Interface IncludeTags

@Retention(RUNTIME) @Target(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.

  • ","
  • "("
  • ")"
  • "&"
  • "|"
  • "!"
Since:
1.0
See Also:

  • Required Element Summary

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

  • Element Details

    • value

      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).