7.2 JavaScript 互操作 on 编程那些事儿

7.2.1 浏览器与 DOM API

Sun, 13 Sep 2026 08:50:47 +0800

原文链接: https://kotlinlang.org/docs/browser-api-dom.html

7.2.1 浏览器与 DOM API

kotlinx-browser 库让你可以访问浏览器特有的功能。它包含 document 和 window 这类常用的顶层对象，并在可能的情况下为它们的功能提供类型安全的封装。

作为后备方案，dynamic 类型可以访问那些无法很好地映射到 Kotlin 类型系统中的函数。

7.2.2 从 Kotlin 使用 JavaScript 代码

Sun, 13 Sep 2026 08:50:47 +0800

原文链接: https://kotlinlang.org/docs/js-interop.html

7.2.2 从 Kotlin 使用 JavaScript 代码

Kotlin 最初就是为与 Java 平台轻松互操作而设计的：它把 Java 类视为 Kotlin 类，而 Java 也把 Kotlin 类视为 Java 类。

不过，JavaScript 是动态类型语言，也就是说它不会在编译期检查类型。你可以通过 dynamic 类型自由地与 JavaScript 交互。如果你想利用 Kotlin 类型系统的全部能力，可以为 JavaScript 库创建外部声明，Kotlin 编译器和相关工具链都能理解它们。

7.2.3 动态类型

Sun, 13 Sep 2026 08:50:47 +0800

原文链接: https://kotlinlang.org/docs/dynamic-type.html

7.2.3 动态类型

注意： 面向 JVM 的代码不支持动态类型。

作为静态类型语言，Kotlin 仍然需要与无类型或弱类型的环境（例如 JavaScript 生态）互操作。为方便这些用例，语言中提供了 dynamic 类型：

7.2.4 使用来自 npm 的依赖

Sun, 13 Sep 2026 08:50:47 +0800

原文链接: https://kotlinlang.org/docs/using-packages-from-npm.html

7.2.4 使用来自 npm 的依赖

在 Kotlin/JS 项目中，所有依赖都可以通过 Gradle 插件来管理。这包括 kotlinx.coroutines、kotlinx.serialization 或 ktor-client 这样的 Kotlin/Multiplatform 库。

7.2.5 从 JavaScript 使用 Kotlin 代码

Sun, 13 Sep 2026 08:50:47 +0800

原文链接: https://kotlinlang.org/docs/js-to-kotlin-interop.html

7.2.5 从 JavaScript 使用 Kotlin 代码

根据所选的 JavaScript 模块系统，Kotlin/JS 编译器会生成不同的输出。但总的来说，Kotlin 编译器会生成普通的 JavaScript 类、函数和属性，你可以在 JavaScript 代码中自由使用它们。不过有一些细微之处需要记住。

7.2.6 JavaScript 模块

Sun, 13 Sep 2026 08:50:47 +0800

原文链接: https://kotlinlang.org/docs/js-modules.html

7.2.6 JavaScript 模块

你可以把 Kotlin 项目编译为适用于各种流行模块系统的 JavaScript 模块。目前我们支持以下 JavaScript 模块配置：

ES Modules，即 JavaScript 中声明模块的标准方式（使用 JavaScript 的 import/export 语法）。当 target 设为 es2015 时默认使用它。
统一模块定义 (UMD)，它同时兼容 AMD 和 CommonJS。UMD 模块也可以在不被导入、或不存在模块系统的情况下执行。这是 browser 和 nodejs 目标的默认选项。
异步模块定义 (AMD)，RequireJS 库尤其使用它。
CommonJS，被 Node.js/npm 广泛使用（require 函数和 module.exports 对象）。
Plain。不为任何模块系统编译。你可以按名称在全局作用域中访问模块。

浏览器目标

如果你打算在 Web 浏览器环境中运行代码，并且想使用 UMD 之外的模块系统，可以在 webpackTask 配置块中指定所需的模块类型。例如，要切换到 CommonJS，请使用：

7.2.7 Kotlin/JS 反射

Sun, 13 Sep 2026 08:50:47 +0800

原文链接: https://kotlinlang.org/docs/js-reflection.html

7.2.7 Kotlin/JS 反射

Kotlin/JS 对 Kotlin 反射 API提供有限支持。API 中受支持的部分只有：

类引用（::class）
KType 与 typeof()
KClass 与 createInstance()

类引用

::class 语法会返回对某个实例所属类的引用，或与给定类型相对应的类。在 Kotlin/JS 中，::class 表达式的值是一个精简版的 KClass 实现，它只支持：

7.2.8 类型安全的 HTML DSL

Sun, 13 Sep 2026 08:50:47 +0800

原文链接: https://kotlinlang.org/docs/typesafe-html-dsl.html

7.2.8 类型安全的 HTML DSL

kotlinx.html 库提供了用静态类型 HTML 构建器生成 DOM 元素的能力（除了 JavaScript 之外，它甚至也能用于 JVM 目标！）。要使用这个库，请把相应的仓库和依赖加入我们的 build.gradle.kts 文件：