org.junit.jupiter.api

Annotation Type Tag

@Target(value={TYPE,METHOD})
 @Retention(value=RUNTIME)
 @Documented
 @Repeatable(value=Tags.class)
 @API(value=Maintained)
public @interface Tag

@Tag is a repeatable annotation that is used to declare a tag for the annotated test class or test method.

Tags are used to filter which tests are executed for a given test plan. For example, a development team may tag tests with values such as "fast", "slow", "ci-server", etc. and then supply a list of tags to be used for the current test plan, potentially dependent on the current environment.

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.

Since:

5.0

See Also:

Tags, Test

Required Element Summary

Required Elements

Modifier and Type	Required Element and Description
java.lang.String	value The tag.

Element Detail

value

public abstract java.lang.String value

The tag.

Note: the tag will first be trimmed. If the supplied tag is syntactically invalid after trimming, the error will be logged as a warning, and the invalid tag will be effectively ignored. See Syntax Rules for Tags.