Spec-Zone.ru › Kotlin 1.6

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

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

Плагин Kotlin/JS 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 Debug. Для добавления такой конфигурации:

  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.

Последнее изменение: 07 апреля 2022
Сервер разработки и непрерывная компиляция Запуск тестов в Kotlin/JS

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