Spec-Zone.ru › Kotlin 1.9

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

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

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

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

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

Для отладки Kotlin/JS в браузере:

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

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

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

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

Debugging in Chrome DevTools

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

Отладка в IDE

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

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

  1. Перейдите в Выполнить | Редактировать конфигурации.

  2. Нажмите + и выберите Отладчик JavaScript.

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

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

Узнайте больше о настройке конфигураций отладчика JavaScript.

Теперь вы готовы отлаживать свой проект!

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

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

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

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

Теперь вы можете начать отладку программы, используя весь набор инструментов, предлагаемых 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

Последнее изменение: 19 июня 2023 г.
Сервер разработки и непрерывная компиляция Запуск тестов в Kotlin/JS

© 2010–2023 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