org.junit.jupiter.api

Annotation Type TestInstance

@Target(value=TYPE)
 @Retention(value=RUNTIME)
 @Inherited
 @Documented
public @interface TestInstance

@TestInstance is a class-level annotation that is used to configure the lifecycle of test instances for the annotated test class.

If @TestInstance is not declared on a test class, the lifecycle mode will implicitly default to PER_METHOD. Note, however, that an explicit lifecycle mode is inherited within a test class hierarchy.

Use Cases

Setting the test instance lifecycle mode to PER_CLASS enables the following features.

• Shared test instance state between test methods in a given test class as well as between non-static @BeforeAll and @AfterAll methods in the test class.
• Declaration of @BeforeAll and @AfterAll methods in @Nested test classes.
• Declaration of @BeforeAll and @AfterAll on interface default methods.
• Simplified declaration of @BeforeAll and @AfterAll methods in test classes implemented with the Kotlin programming language.

Since:

5.0

Required Element Summary

Required Elements

Modifier and Type	Required Element and Description
TestInstance.Lifecycle	value The test instance lifecycle mode to use.

Element Detail

value

public abstract TestInstance.Lifecycle value

The test instance lifecycle mode to use.