Package org.junit.jupiter.api
JUnit Jupiter API for writing tests.
-
Interface Summary Interface Description DisplayNameGenerator DisplayNameGenerator
defines the SPI for generating display names programmatically.MethodDescriptor MethodDescriptor
encapsulates functionality for a givenMethod
.MethodOrderer MethodOrderer
defines the API for ordering the test methods in a given test class.MethodOrdererContext MethodOrdererContext
encapsulates the context in which aMethodOrderer
will be invoked.RepetitionInfo RepetitionInfo
is used to inject information about the current repetition of a repeated test into@RepeatedTest
,@BeforeEach
, and@AfterEach
methods.TestInfo TestInfo
is used to inject information about the current test or container into to@Test
,@RepeatedTest
,@ParameterizedTest
,@TestFactory
,@BeforeEach
,@AfterEach
,@BeforeAll
, and@AfterAll
methods.TestReporter Parameters of typeTestReporter
can be injected into@BeforeEach
and@AfterEach
lifecycle methods as well as methods annotated with@Test
,@RepeatedTest
,@ParameterizedTest
,@TestFactory
, etc. -
Class Summary Class Description Assertions Assertions
is a collection of utility methods that support asserting conditions in tests.Assumptions Assumptions
is a collection of utility methods that support conditional test execution based on assumptions.DisplayNameGenerator.ReplaceUnderscores Replace all underscore characters with spaces.DisplayNameGenerator.Standard Standard display name generator.DynamicContainer ADynamicContainer
is a container generated at runtime.DynamicNode DynamicNode
serves as the abstract base class for a container or a test case generated at runtime.DynamicTest ADynamicTest
is a test case generated at runtime.MethodOrderer.Alphanumeric MethodOrderer
that sorts methods alphanumerically based on their names usingString.compareTo(String)
.MethodOrderer.OrderAnnotation MethodOrderer
that sorts methods based on the@Order
annotation.MethodOrderer.Random MethodOrderer
that orders methods pseudo-randomly and allows for concurrent execution by default. -
Enum Summary Enum Description TestInstance.Lifecycle Enumeration of test instance lifecycle modes. -
Annotation Types Summary Annotation Type Description AfterAll @AfterAll
is used to signal that the annotated method should be executed after all tests in the current test class.AfterEach @AfterEach
is used to signal that the annotated method should be executed after each@Test
,@RepeatedTest
,@ParameterizedTest
,@TestFactory
, and@TestTemplate
method in the current test class.BeforeAll @BeforeAll
is used to signal that the annotated method should be executed before all tests in the current test class.BeforeEach @BeforeEach
is used to signal that the annotated method should be executed before each@Test
,@RepeatedTest
,@ParameterizedTest
,@TestFactory
, and@TestTemplate
method in the current test class.Disabled @Disabled
is used to signal that the annotated test class or test method is currently disabled and should not be executed.DisplayName @DisplayName
is used to declare a custom display name for the annotated test class or test method.DisplayNameGeneration @DisplayNameGeneration
is used to declare a custom display name generator for the annotated test class.Nested @Nested
is used to signal that the annotated class is a nested, non-static test class (i.e., an inner class) that can share setup and state with an instance of its enclosing class.Order @Order
is an annotation that is used to configure the order in which the annotated element (i.e., field or method) should be evaluated or executed relative to other elements of the same category.RepeatedTest @RepeatedTest
is used to signal that the annotated method is a test template method that should be repeated a specified number of times with a configurable display name.Tag @Tag
is a repeatable annotation that is used to declare a tag for the annotated test class or test method.Tags @Tags
is a container for one or more@Tag
declarations.Test @Test
is used to signal that the annotated method is a test method.TestFactory @TestFactory
is used to signal that the annotated method is a test factory method.TestInstance @TestInstance
is a type-level annotation that is used to configure the lifecycle of test instances for the annotated test class or test interface.TestMethodOrder @TestMethodOrder
is a type-level annotation that is used to configure aMethodOrderer
for the test methods of the annotated test class or test interface.TestTemplate @TestTemplate
is used to signal that the annotated method is a test template method.