type: doc layout: reference category: "JavaScript"

title: "JavaScript DCE"

JavaScript 无用代码消除（DCE）

Kotlin/JS Gradle 插件包含一个无用代码消除（DCE）工具。 无用代码消除通常也称为 摇树。 通过删除未使用的属性、函数和类，它减小了大小或生成的 JavaScript 代码。

在以下情况下会出现未使用的声明：

• 函数是内联的，永远不会直接调用（除了少数情况总是发生）。
• 模块使用共享库。没有 DCE 的情况下，未使用的组件仍会进入结果包。 例如，Kotlin 标准库中包含用于操作列表、数组、字符序列、DOM 适配器的函数。 它们总共构成了大约 1.3MB 的文件。 一个简单的 "Hello, world" 应用程序仅需要控制台例程，整个程序只有几 KB。

Kotlin/JS Gradle 插件在构建生产包时会自动处理 DCE，例如：使用 browserProductionWebpack 任务。 开发捆绑任务不包括 DCE。

从 DCE 排除的声明

有时，即使未在模块中使用函数或类，也可能需要在结果 JavaScript 代码中保留一个函数或一个类， 例如：如果要在客户端 JavaScript 代码中使用它，则可能会保留该函数或类。

为了避免某些声明被删除，请将 dceTask 代码块添加到 Gradle 构建脚本中，并将这些声明列为 keep 函数的参数。 参数必须是声明的完整限定名，并且模块名称为前缀： moduleName.dot.separated.package.name.declarationName

Groovy DSL

kotlin.target.browser {
    dceTask {
        keep 'myKotlinJSModule.org.example.getName', 'myKotlinJSModule.org.example.User'
    }
}

Kotlin DSL

kotlin.target.browser {
    dceTask {
        keep("myKotlinJSModule.org.example.getName", "myKotlinJSModule.org.example.User" )
    }
}

请注意，带有参数的函数名称在生成的 JavaScript 代码中会被修饰。 为了避免消除这些函数，请在 keep 参数中使用修饰的名称。

已知问题：DCE 与 ktor

在 Kotlin 中，存在一个在 Kotlin/JS 项目中使用 ktor 的已知问题。 在某些情况下，可能会遇到类型错误，例如：<something> is not a function 这是来自 io.ktor:ktor-client-js:1.3.0 或 io.ktor:ktor-client-core:1.3.0 构件。 为避免此问题，请添加以下 DCE 配置：

Groovy DSL

kotlin.target.browser {
    dceTask {
        keep 'ktor-ktor-io.\$\$importsForInline\$\$.ktor-ktor-io.io.ktor.utils.io'
    }
}

Kotlin DSL

kotlin.target.browser {
    dceTask {
        keep("ktor-ktor-io.\$\$importsForInline\$\$.ktor-ktor-io.io.ktor.utils.io")
    }
}