Устранение неиспользуемого кода в Kotlin/JS

Плагин Kotlin/JS Gradle содержит инструмент устранения неиспользуемого кода (DCE). Устранение неиспользуемого кода также часто называют сжатием дерева. Оно уменьшает размер результирующего JavaScript-кода, удаляя неиспользуемые свойства, функции и классы.

Неиспользуемые объявления могут встречаться в следующих случаях:

• Функция инлайнизирована и никогда не вызывается напрямую (что происходит всегда, за исключением нескольких ситуаций).

• Модуль использует общую библиотеку. Без DCE в результирующий пакет всё равно включаются части библиотеки, которыми вы не пользуетесь. Например, стандартная библиотека Kotlin содержит функции для работы со списками, массивами, последовательностями символов, адаптерами для DOM и так далее. Всё это функциональное обеспечение потребовало бы примерно 1,3 МБ в виде JavaScript-файла. Простое приложение «Привет, мир» требует только рутины для работы с консолью, что составляет всего несколько килобайт для всего файла.

Плагин Kotlin/JS Gradle автоматически обрабатывает DCE при построении пакета для производства, например, с помощью задачи browserProductionWebpack. Задачи сборки для разработки (например, browserDevelopmentWebpack) не включают DCE.

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

kotlin {
    js {
        browser {
            dceTask {
                dceOptions.devMode = true
            }
        }
        binaries.executable()
    }
}