Spec-Zone.ru › Kotlin 2

Отладка кода Kotlin/JS

Карты кода JavaScript связывают минифицированный код, созданный сборщиками или минификаторами, с исходным кодом, с которым работает разработчик. Благодаря этому карты кода позволяют отлаживать код во время его выполнения.

Плагин Kotlin Multiplatform Gradle автоматически создает карты кода для сборок проекта, поэтому они доступны без дополнительной настройки.

Отладка в браузере

Большинство современных браузеров предоставляют инструменты для просмотра содержимого страницы и отладки выполняющегося на ней кода. Подробнее см. в документации вашего браузера.

Чтобы отлаживать Kotlin/JS в браузере:

  1. Запустите проект, выполнив одну из доступных задач Gradle run, например, jsBrowserDevelopmentRun. Подробнее о запуске Kotlin/JS.

  2. Откройте страницу в браузере и запустите инструменты разработчика (например, щелкнув правой кнопкой мыши и выбрав действие Inspect). Узнайте, как найти инструменты разработчика в популярных браузерах.

  3. Если ваша программа выводит информацию в консоль, перейдите на вкладку Console, чтобы увидеть этот вывод. В зависимости от браузера эти записи могут ссылаться на исходные файлы Kotlin и строки, из которых они получены:

    Chrome DevTools console
  4. Щелкните ссылку на файл справа, чтобы перейти к соответствующей строке кода. Также можно вручную открыть вкладку Sources и найти нужный файл в дереве файлов. При переходе к файлу Kotlin отображается обычный код Kotlin (а не минифицированный JavaScript):

Debugging in Chrome DevTools

Теперь можно приступить к отладке программы. Установите точку останова, щелкнув номер строки. Инструменты разработчика позволяют устанавливать точки останова даже внутри оператора. Как и в обычном коде JavaScript, установленные точки останова сохраняются при перезагрузке страницы. Это также позволяет отлаживать метод main() в Kotlin, который выполняется при первой загрузке скрипта.

Отладка в IDE

IntelliJ IDEA с подпиской Ultimate предоставляет мощный набор инструментов для отладки кода во время разработки.

Для отладки Kotlin/JS в IntelliJ IDEA потребуется конфигурация JavaScript Debug. Чтобы добавить такую конфигурацию отладки:

  1. Перейдите в раздел Run | Edit Configurations.

  2. Нажмите + и выберите JavaScript Debug.

  3. Укажите Name конфигурации и задайте URL, по которому работает проект (по умолчанию — http://localhost:8080).

    JavaScript debug configuration
  4. Сохраните конфигурацию.

Подробнее о настройке конфигураций отладки JavaScript.

Теперь можно приступать к отладке проекта!

  1. Запустите проект, выполнив одну из доступных задач Gradle run, например, jsBrowserDevelopmentRun. Подробнее о запуске Kotlin/JS.

  2. Запустите сеанс отладки, выполнив созданную ранее конфигурацию отладки JavaScript:

    JavaScript debug configuration
  3. Вывод консоли программы можно увидеть в окне Debug в IntelliJ IDEA. Элементы вывода ссылаются на исходные файлы Kotlin и строки, из которых они получены:

    JavaScript debug output in the IDE
  4. Щелкните ссылку на файл справа, чтобы перейти к соответствующей строке кода.

Теперь можно отлаживать программу с помощью всего набора инструментов IDE: точек останова, пошагового выполнения, вычисления выражений и многого другого. Подробнее об отладке в IntelliJ IDEA.

Из-за ограничений текущего отладчика JavaScript в IntelliJ IDEA может потребоваться перезапустить отладку JavaScript, чтобы выполнение остановилось на точках останова.

Отладка в Node.js

Если проект предназначен для Node.js, его можно отлаживать в этой среде выполнения.

Чтобы отладить приложение Kotlin/JS, предназначенное для Node.js:

  1. Соберите проект, выполнив задачу Gradle build.

  2. Найдите полученный файл .js для Node.js в каталоге build/js/packages/your-module/kotlin/ внутри каталога проекта.

  3. Отладьте его в Node.js, следуя инструкциям из руководства по отладке Node.js.

Что дальше?

Теперь, когда вы знаете, как запускать сеансы отладки проекта Kotlin/JS, узнайте, как эффективно использовать инструменты отладки:

  • Узнайте, как отлаживать JavaScript в Google Chrome

  • Познакомьтесь с отладчиком JavaScript в IntelliJ IDEA

  • Узнайте, как отлаживать код в Node.js.

Если возникли проблемы

Если у вас возникли проблемы с отладкой Kotlin/JS, сообщите о них в наш трекер ошибок YouTrack

12 августа 2026 г.
Сервер разработки и непрерывная компиляцияЗапуск тестов в Kotlin/JS

© 2010–2026 JetBrains s.r.o. and Kotlin Programming Language contributors
Licensed under the Apache License, Version 2.0.
https://kotlinlang.org/docs/js-debugging.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API