Interface ExtensionContext

    • Method Detail

      • getParent

        Optional<ExtensionContext> getParent()
        Get the parent extension context, if available.
        Returns:
        an Optional containing the parent; never null but potentially empty
        See Also:
        getRoot()
      • getRoot

        ExtensionContext getRoot()
        Get the root ExtensionContext.
        Returns:
        the root extension context; never null but potentially this ExtensionContext
        See Also:
        getParent()
      • getUniqueId

        String getUniqueId()
        Get the unique ID of the current test or container.
        Returns:
        the unique ID of the test or container; never null or blank
      • getDisplayName

        String getDisplayName()
        Get the display name for the current test or container.

        The display name is either a default name or a custom name configured via @DisplayName.

        For details on default display names consult the Javadoc for TestInfo.getDisplayName().

        Note that display names are typically used for test reporting in IDEs and build tools and may contain spaces, special characters, and even emoji.

        Returns:
        the display name of the test or container; never null or blank
      • getTags

        Set<String> getTags()
        Get the set of all tags for the current test or container.

        Tags may be declared directly on the test element or inherited from an outer context.

        Returns:
        the set of tags for the test or container; never null but potentially empty
      • getElement

        Optional<AnnotatedElement> getElement()
        Get the AnnotatedElement corresponding to the current extension context, if available.

        For example, if the current extension context encapsulates a test class, test method, test factory method, or test template method, the annotated element will be the corresponding Class or Method reference.

        Favor this method over more specific methods whenever the AnnotatedElement API suits the task at hand — for example, when looking up annotations regardless of concrete element type.

        Returns:
        an Optional containing the AnnotatedElement; never null but potentially empty
        See Also:
        getTestClass(), getTestMethod()
      • getTestClass

        Optional<Class<?>> getTestClass()
        Get the Class associated with the current test or container, if available.
        Returns:
        an Optional containing the class; never null but potentially empty
        See Also:
        getRequiredTestClass()
      • getRequiredTestClass

        default Class<?> getRequiredTestClass()
        Get the required Class associated with the current test or container.

        Use this method as an alternative to getTestClass() for use cases in which the test class is required to be present.

        Returns:
        the test class; never null
        Throws:
        PreconditionViolationException - if the test class is not present in this ExtensionContext
      • getRequiredTestInstance

        default Object getRequiredTestInstance()
        Get the required test instance associated with the current test or container.

        Use this method as an alternative to getTestInstance() for use cases in which the test instance is required to be present.

        Returns:
        the test instance; never null
        Throws:
        PreconditionViolationException - if the test instance is not present in this ExtensionContext
        See Also:
        getRequiredTestInstances()
      • getTestInstances

        @API(status=STABLE,
             since="5.7")
        Optional<TestInstances> getTestInstances()
        Get the test instances associated with the current test or container, if available.

        While top-level tests only have a single test instance, nested tests have one additional instance for each enclosing test class.

        Returns:
        an Optional containing the test instances; never null but potentially empty
        Since:
        5.4
        See Also:
        getRequiredTestInstances()
      • getRequiredTestInstances

        @API(status=STABLE,
             since="5.7")
        default TestInstances getRequiredTestInstances()
        Get the required test instances associated with the current test or container.

        Use this method as an alternative to getTestInstances() for use cases in which the test instances are required to be present.

        Returns:
        the test instances; never null
        Throws:
        PreconditionViolationException - if the test instances are not present in this ExtensionContext
        Since:
        5.4
      • getTestMethod

        Optional<Method> getTestMethod()
        Get the Method associated with the current test, if available.
        Returns:
        an Optional containing the method; never null but potentially empty
        See Also:
        getRequiredTestMethod()
      • getRequiredTestMethod

        default Method getRequiredTestMethod()
        Get the required Method associated with the current test or container.

        Use this method as an alternative to getTestMethod() for use cases in which the test method is required to be present.

        Returns:
        the test method; never null
        Throws:
        PreconditionViolationException - if the test method is not present in this ExtensionContext
      • getExecutionException

        Optional<Throwable> getExecutionException()
        Get the exception that was thrown during execution of the test or container associated with this ExtensionContext, if available.

        This method is typically used for logging and tracing purposes. If you wish to actually handle an exception thrown during test execution, implement the TestExecutionExceptionHandler API.

        Unlike the exception passed to a TestExecutionExceptionHandler, an execution exception returned by this method can be any exception thrown during the invocation of a @Test method, its surrounding @BeforeEach and @AfterEach methods, or a test-level Extension. Similarly, if this ExtensionContext represents a test class, the execution exception returned by this method can be any exception thrown in a @BeforeAll or AfterAll method or a class-level Extension.

        Note, however, that this method will never return an exception swallowed by a TestExecutionExceptionHandler. Furthermore, if multiple exceptions have been thrown during test execution, the exception returned by this method will be the first such exception with all additional exceptions suppressed in the first one.

        Returns:
        an Optional containing the exception thrown; never null but potentially empty if test execution has not (yet) resulted in an exception
      • getConfigurationParameter

        @API(status=STABLE,
             since="5.1")
        Optional<String> getConfigurationParameter​(String key)
        Get the configuration parameter stored under the specified key.

        If no such key is present in the ConfigurationParameters for the JUnit Platform, an attempt will be made to look up the value as a JVM system property. If no such system property exists, an attempt will be made to look up the value in the JUnit Platform properties file.

        Parameters:
        key - the key to look up; never null or blank
        Returns:
        an Optional containing the value; never null but potentially empty
        Since:
        5.1
        See Also:
        System.getProperty(String), ConfigurationParameters
      • getConfigurationParameter

        @API(status=EXPERIMENTAL,
             since="5.7")
        <T> Optional<T> getConfigurationParameter​(String key,
                                                  Function<String,​T> transformer)
        Get and transform the configuration parameter stored under the specified key using the specified transformer.

        If no such key is present in the ConfigurationParameters for the JUnit Platform, an attempt will be made to look up the value as a JVM system property. If no such system property exists, an attempt will be made to look up the value in the JUnit Platform properties file.

        In case the transformer throws an exception, it will be wrapped in a JUnitException with a helpful message.

        Parameters:
        key - the key to look up; never null or blank
        transformer - the transformer to apply in case a value is found; never null
        Returns:
        an Optional containing the value; never null but potentially empty
        Since:
        5.7
        See Also:
        System.getProperty(String), ConfigurationParameters