Suite • opensavvy.prepared.suite • TestDsl
TestDsl
interface TestDsl : PreparedDsl
A test declaration.
This interface is most often used as a test declaration: `suspend TestDsl.() -> Unit`.
Tests allow to control the time. For more information, read time.
Design notes
It is our goal to keep this interface as lightweight as possible, because any field we add here risks being shadowed by local variables in the tests.
For example, if we were to add a member called `foo`, then this code…
…shadows the member 'foo'.
Instead, we add all fields to TestEnvironment, and create extension functions which expose the most important functionality.
Note to runner implementors
If you are implementing your own test runner, you will need to provide an instance of this interface. Because it encapsulates the whole test machinery, we recommend using runTestDsl instead of making your own implementation.
See also
Properties
backgroundScope
CoroutineScope for services started by this test.
environment
abstract val environment: TestEnvironment
Metadata about the running test.
foregroundScope
CoroutineScope for tasks started by this test.