Testing coroutines with runTest in Kotlin - Step-by-Step Execution

Concept Flow - Testing coroutines with runTest

Start runTest

↓

Launch coroutine

↓

Execute coroutine code

↓

Advance virtual time if needed

↓

Check assertions

↓

End runTest

runTest starts a coroutine test, runs coroutine code with virtual time control, then checks assertions before finishing.

Execution Sample

Kotlin

import kotlinx.coroutines.test.runTest
import kotlin.test.assertEquals

suspend fun suspendFunction(): Int {
    return 42
}

runTest {
  val result = suspendFunction()
  assertEquals(42, result)
}

This code runs a coroutine test that calls a suspend function and asserts its result equals 42.

Execution Table

Step	Action	Evaluation	Result
1	Start runTest block	runTest starts coroutine test environment	Coroutine test environment ready
2	Call suspendFunction()	Suspend function executes	Returns 42
3	Assert result == 42	Check if result equals 42	Assertion passes
4	End runTest	Test completes successfully	Test passed

💡 Test ends after assertions pass and runTest block completes

Variable Tracker

Variable	Start	After Step 2	After Step 3	Final
result	undefined	42	42	42

Key Moments - 2 Insights

Why does runTest allow testing suspend functions without blocking?

runTest creates a special coroutine environment with virtual time, so suspend functions run without real delays, as shown in Step 2 of the execution_table.

What happens if the assertion fails inside runTest?

If the assertion fails (Step 3), runTest throws an error and the test stops immediately, indicating failure.

Visual Quiz - 3 Questions

Look at the execution_table, what is the value of 'result' after Step 2?

A undefined

B 42

C null

D 0

💡 Hint

Check the variable_tracker row for 'result' after Step 2

At which step does the assertion check happen in the execution_table?

A Step 1

B Step 2

C Step 3

D Step 4

💡 Hint

Look for the row where 'Assert result == 42' is the action

If suspendFunction() returned 10 instead of 42, what would happen in the execution_table?

A Assertion fails at Step 3

B Assertion passes at Step 3

C Test ends at Step 2

D runTest never starts

💡 Hint

Refer to Step 3 where the assertion compares result to 42

Concept Snapshot

runTest {
  // coroutine test code
}

- Runs suspend functions in a test coroutine
- Uses virtual time to avoid delays
- Allows assertions inside coroutine
- Ends when block completes or assertion fails

Full Transcript

This visual execution shows how runTest runs coroutine tests in Kotlin. First, runTest starts a special coroutine environment. Then, the suspend function is called and returns a value. Next, an assertion checks the result. Finally, runTest ends the test. Variables like 'result' update as the code runs. If assertions fail, the test stops immediately. This helps test asynchronous code easily without real delays.