Kotlin Academy · 课时

协程测试

Q: 「协程测试」这节课中我会学到什么？

测试挂起函数 你通过在浏览器中直接运行的动手代码来练习 Kotlin Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

测试挂起函数

第 4 / 4 课13 个步骤

协程测试 是 CoddyKit 上的免费 Kotlin Academy 课时。这是第 4 节课，共 4 节。你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。这是 Kotlin Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Kotlin Academy 课程共包含 4 节课。

为什么协程测试特殊

协程会异步运行，并且可能使用延迟。测试需要可控时间，还需要一种等待挂起函数完成的方法。

kotlinx-coroutines-test 库正好提供了这些功能。

添加测试库

将协程测试构件添加到测试依赖项中。

dependencies {
    testImplementation("org.jetbrains.kotlinx:kotlinx-coroutines-test:1.8.1")
}

runTest

runTest 是入口点。它会运行协程测试主体，并自动等待所有子协程完成。

import kotlinx.coroutines.test.runTest
import org.junit.jupiter.api.Test

class FetchTest {
    @Test
    fun fetches() = runTest {
        // suspend calls allowed here
    }
}

虚拟时间

在 runTest 中，delay 调用会使用虚拟时间跳过。10 秒的延迟会立即完成，同时保持执行顺序。

import kotlinx.coroutines.delay
import kotlinx.coroutines.test.runTest

// runTest {
//     delay(10_000) // returns immediately
// }

手动推进时间

测试调度器允许您使用 advanceTimeBy 有意推进时间，并使用 runCurrent 运行待处理的工作。

import kotlinx.coroutines.test.runTest
import kotlinx.coroutines.test.advanceTimeBy
import kotlinx.coroutines.test.runCurrent

// runTest {
//     launch { delay(1000); println("done") }
//     advanceTimeBy(1000)
//     runCurrent()
// }

测试调度器

StandardTestDispatcher 会将协程排队，直到您推进时间。UnconfinedTestDispatcher 会立即运行协程。请根据所需的控制程度进行选择。

import kotlinx.coroutines.test.StandardTestDispatcher
import kotlinx.coroutines.test.UnconfinedTestDispatcher

val standard = StandardTestDispatcher()
val unconfined = UnconfinedTestDispatcher()

注入调度器

生产代码应该接收调度器，而不是将 Dispatchers.IO 硬编码其中。这样，测试就可以注入测试调度器。

import kotlinx.coroutines.CoroutineDispatcher
import kotlinx.coroutines.Dispatchers
import kotlinx.coroutines.withContext

class Service(private val io: CoroutineDispatcher = Dispatchers.IO) {
    suspend fun load(): String = withContext(io) { "data" }
}

替换 Dispatchers.Main

对于 Android 风格的代码，请使用 Dispatchers.setMain(testDispatcher) 替换主调度器，并在之后将其重置。

import kotlinx.coroutines.Dispatchers
import kotlinx.coroutines.test.setMain
import kotlinx.coroutines.test.resetMain
import kotlinx.coroutines.test.StandardTestDispatcher

// Dispatchers.setMain(StandardTestDispatcher())
// ... test ...
// Dispatchers.resetMain()

测试挂起函数

可以直接在 runTest 内调用挂起函数并进行断言。

import kotlinx.coroutines.delay
import kotlinx.coroutines.test.runTest
import org.junit.jupiter.api.Assertions.assertEquals

suspend fun compute(): Int { delay(1000); return 42 }

// @Test fun computes() = runTest {
//     assertEquals(42, compute())
// }

测试流

收集 Flow 并对发出的值进行断言。Turbine 库可以让流测试特别简洁。

import kotlinx.coroutines.flow.flowOf
import kotlinx.coroutines.flow.toList
import kotlinx.coroutines.test.runTest
import org.junit.jupiter.api.Assertions.assertEquals

// @Test fun emits() = runTest {
//     val values = flowOf(1, 2, 3).toList()
//     assertEquals(listOf(1, 2, 3), values)
// }

可运行的协程代码片段

在测试之外，runBlocking 可以将挂起代码连接到普通的 main。这展示了被测试的挂起函数。

import kotlinx.coroutines.runBlocking
import kotlinx.coroutines.delay

suspend fun compute(): Int { delay(100); return 42 }

fun main() = runBlocking {
    println(compute())
}

快速检查

某个挂起函数调用了 delay(5000)。为什么使用 runTest 的测试几乎会立即完成？

在交互式课程中回答

回顾

您可以可靠地测试协程：

runTest 运行挂起代码并等待子协程完成
虚拟时间会跳过延迟；必要时可以手动推进时间
注入调度器；使用 setMain/resetMain
通过收集流（或使用 Turbine）测试流

测试课程到此完成。

免费开始

用 AI 导师学习 Kotlin — 免费

在浏览器中编写并运行真实代码，获得全天候 AI 导师的即时帮助，并在网页或应用中继续学习。

课程: 51
课程: 203

免费开始学习查看完整课程

常见问题解答

「协程测试」课时是免费的吗？

是的 — 「协程测试」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Kotlin Academy 课程的其余内容，请升级到 CoddyKit PRO。 Kotlin Academy 课程共包含 4 节课。

「协程测试」这节课中我会学到什么？

测试挂起函数你通过在浏览器中直接运行的动手代码来练习 Kotlin Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 Kotlin Academy 需要有经验吗？

无需任何先前经验。CoddyKit 上的 Kotlin Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。这是第 4 节课，共 4 节。

「协程测试」课时需要多长时间？

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。

我能在这节 Kotlin Academy 课中编写并运行代码吗？

能。每节 Kotlin Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

← 返回 Kotlin Academy