kotlinx-coroutines-test/kotlinx.coroutines.test/TestCoroutineScope

TestCoroutineScope

@ExperimentalCoroutinesApi
interface TestCoroutineScope : CoroutineScope

A scope which provides detailed control over the execution of coroutines for tests.

This scope is deprecated in favor of TestScope. Please see the migration guide for an instruction on how to update the code for the new API.

Functions

Link copied to clipboard
@ExperimentalCoroutinesApi
abstract fun cleanupTestCoroutines()

Called after the test completes.

Properties

Link copied to clipboard
@ExperimentalCoroutinesApi
abstract val testScheduler: TestCoroutineScheduler

The delay-skipping scheduler used by the test dispatchers running the code in this scope.

Extensions

Link copied to clipboard
@ExperimentalCoroutinesApi
fun TestCoroutineScope.advanceTimeBy(delayTimeMillis: Long)

Advances the testScheduler by delayTimeMillis and runs the tasks up to that moment (inclusive).

Link copied to clipboard
@ExperimentalCoroutinesApi
fun TestCoroutineScope.advanceUntilIdle()

Advances the testScheduler to the point where there are no tasks remaining.

Link copied to clipboard
Link copied to clipboard
Link copied to clipboard
Link copied to clipboard
fun TestCoroutineScope.runBlockingTest(block: suspend TestCoroutineScope.() -> Unit)

Convenience method for calling runBlockingTest on an existing TestCoroutineScope.

Link copied to clipboard
@ExperimentalCoroutinesApi
fun TestCoroutineScope.runCurrent()

Run any tasks that are pending at the current virtual time, according to the testScheduler.

Link copied to clipboard
@ExperimentalCoroutinesApi
fun TestCoroutineScope.runTest(dispatchTimeoutMs: Long = DEFAULT_DISPATCH_TIMEOUT_MS, block: suspend TestCoroutineScope.() -> Unit): TestResult

Runs a test in a TestCoroutineScope based on this one.

Link copied to clipboard
val TestCoroutineScope.uncaughtExceptions: List<Throwable>

List of uncaught coroutine exceptions, for backward compatibility.