Spec-Zone.ru › Kotlin 1.7

Отладка кода 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. Чтобы добавить такую конфигурацию:

  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

Последнее изменение: 01 декабря 2021 г.
Сервер разработки и непрерывная компиляция Запуск тестов в 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