- All Known Implementing Classes:
DefaultTestInstances
TestInstances
encapsulates the test instances of a test.
While top-level tests only have a single test instance, nested tests have one additional instance for each enclosing test class.
- Since:
- 5.4
- See Also:
ExtensionContext.getTestInstances()
,ExtensionContext.getRequiredTestInstances()
-
Method Summary
Modifier and TypeMethodDescription<T> Optional<T>
findInstance(Class<T> requiredType)
Find the first test instance that is an instance of the supplied required type, checking from innermost to outermost.Get all test instances, ordered from outermost to innermost.Get the enclosing test instances, excluding the innermost test instance, ordered from outermost to innermost.Get the innermost test instance.
-
Method Details
-
getInnermostInstance
Object getInnermostInstance()Get the innermost test instance.The innermost instance is the one closest to the test method.
- Returns:
- the innermost test instance; never
null
-
getEnclosingInstances
Get the enclosing test instances, excluding the innermost test instance, ordered from outermost to innermost.- Returns:
- the enclosing test instances; never
null
or containingnull
, but potentially empty
-
getAllInstances
Get all test instances, ordered from outermost to innermost.- Returns:
- all test instances; never
null
, containingnull
, or empty
-
findInstance
Find the first test instance that is an instance of the supplied required type, checking from innermost to outermost.- Parameters:
requiredType
- the type to search for- Returns:
- the first test instance of the required type; never
null
but potentially empty
-