Annotation Type IncludeTags

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

    See Also:
    ExcludeTags, TagFilter.includeTags(java.lang.String...), JUnitPlatform
    • Required Element Summary

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

      • value

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