在 Kotlin/JS 中运行测试

Kotlin 多平台 Gradle 插件允许您通过 Gradle 构建配置指定的各种测试运行程序来运行测试。

创建多平台项目时，您可以通过在 commonTest 中使用单个依赖项，为包括 JavaScript 目标在すす的所有源集添加测试依赖项：

KotlinGroovy

// build.gradle.kts

kotlin {
    sourceSets {
         commonTest.dependencies {
            implementation(kotlin("test")) // 这使得测试注解和功能在 JS 中可用
        }
    }
}

// build.gradle

kotlin {
    sourceSets {
        commonTest {
            dependencies {
                implementation kotlin("test") // 这使得测试注解和功能在 JS 中可用
            }
        }
    }
}

您可以通过调整 Gradle 构建脚本中 testTask 代码块中的可用设置，来优化 Kotlin/JS 中测试的执行方式。例如，将 Karma 测试运行程序与 Chrome 无头实例以及 Firefox 实例结合使用的示例如下：

kotlin {
    js {
        browser {
            testTask {
                useKarma {
                    useChromeHeadless()
                    useFirefox()
                }
            }
        }
    }
}

有关可用功能的详细说明，请查看 配置测试任务 的 Kotlin/JS 参考文档。

请注意，默认情况下，该插件不捆绑任何浏览器。这意味着您必须确保目标系统上已安装这些浏览器。

要检查测试是否正确执行，请添加文件 src/jsTest/kotlin/AppTest.kt 并填入以下内容：

import kotlin.test.Test
import kotlin.test.assertEquals

class AppTest {
    @Test
    fun thingsShouldWork() {
        assertEquals(listOf(1,2,3).reversed(), listOf(3,2,1))
    }

    @Test
    fun thingsShouldBreak() {
        assertEquals(listOf(1,2,3).reversed(), listOf(1,2,3))
    }
}

要在浏览器中运行测试，请通过 IntelliJ IDEA 执行 jsBrowserTest 任务，或使用装订区域图标执行全部或单个测试：

或者，如果您想通过命令行运行测试，请使用 Gradle wrapper：

./gradlew jsBrowserTest

在 IntelliJ IDEA 中运行测试后，运行 工具窗口将显示测试结果。您可以点击失败的测试以查看其堆栈跟踪，并通过双击导航到对应的测试实现。

每次运行测试后，无论您以何种方式执行测试，都可以在 build/reports/tests/jsBrowserTest/index.html 中找到由 Gradle 生成的格式规范的测试报告。在浏览器中打开此文件即可查看测试结果的另一份概览：

如果您使用的是上面代码段中所示的示例测试集，则一个测试通过，一个测试失败，从而得出 50% 的测试成功率。要获取有关单个测试用例的更多信息，可以通过提供的超链接进行导航：