Как отладить серверное приложение Node.js?

Прямо сейчас я в основном использую отладку предупреждений с такими инструкциями печати:

sys.puts(sys.inspect(someVariable));

Должен быть лучший способ отладки. Я знаю, что в Google Chrome есть отладчик командной строки. Этот отладчик также доступен для Node.js?

узел-инспектор может спасти день! Используйте его из любого браузера, поддерживающего WebSocket . Точки останова, профилировщик, livecoding и т. Д. Это действительно круто.

Установите его с помощью:

npm install -g node-inspector

Затем запустите:

node-debug app.js

Отладка

• Гид Джойента
• дебаггер
• Инспектор узлов
• Visual Studio Code
• Облако 9
• Скобки

Профилирование

1. node --prof ./app.js
2. node --prof-process ./the-generated-log-file

Heapdumps

• node-heapdump с помощью инструментов разработчика Chrome

Flamegraphs

• 0x
• jam3 / devtool затем Chrome Developer Tools Flame Charts
• Dtrace и StackVis - поддерживаются только в SmartOS
• clinicjs

трассировка

• Интерактивные трассировки стека с помощью TraceGL

логирование

Библиотеки, которые выводят отладочную информацию

• гусеница
• изотопный индикатор
• строчит

Библиотеки, улучшающие информацию трассировки стека

• Длинный Джон

Бенчмаркинг

• Apache Bench :ab -n 100000 -c 1 http://127.0.0.1:9778/
• WRK

Другой

• след
• преимущество
• мудак
• Google Tracing Framework
• Пол Ирландский гид

наследие

Они используются для работы, но больше не поддерживаются или больше не применяются к современным версиям узлов.

• https://github.com/bnoordhuis/node-profiler - заменен встроенной отладкой
• https://github.com/c4milo/node-webkit-agent - заменен инспектором узлов
• https://nodetime.com/ - несуществующий

V8 отладчик выпущен как часть Google Инструменты разработчика Chrome можно использовать для отладки Node.js сценариев. Подробное объяснение того, как это работает, можно найти в вики- сайте Node.js GitHub .

Node имеет собственный встроенный отладчик GUI начиная с версии 6.3 (с использованием Chrome DevTools)

Просто передайте флаг инспектора, и вы получите URL для инспектора:

node --inspect server.js

Вы также можете разбить первую строку, передав --inspect-brkвместо этого.

Node.js версии 0.3.4+ имеет встроенную поддержку отладки.

node debug script.js

Руководство: http://nodejs.org/api/debugger.html

Visual Studio Code будет моим выбором для отладки. Никаких накладных расходов на установку каких-либо инструментов илиnpm installвещей. Просто установите начальную точку вашего приложения в package.json, и VSCode автоматически создаст файл конфигурации внутри вашего решения. ОноснованнаElectron, на котором основаны такие редакторы, как Atom.

VS Code дает такой же опыт отладки, как и в других IDE, таких как VS, Eclipse и т. Д.

Я лично использую JetBrains WebStorm, так как это единственная найденная мной JavaScript IDE, которая отлично подходит как для внешнего, так и для внутреннего JavaScript.

Он работает на нескольких ОС и имеет встроенную отладку Node.js (а также множество других вещей) ( http://www.jetbrains.com/webstorm/features/index.html ).

Мои единственные «вопросы» / пожелания находятся были :

1. Похоже, что на Mac больше ресурсов, чем на Windows Это больше не кажется проблемой в версии 6.
2. Было бы хорошо, если бы у него была поддержка Snippet (как у Sublime Text 2). - то есть наберите 'fun' и нажмите 'tab', чтобы добавить функцию. См. Комментарий @WickyNilliams ниже - с живыми шаблонами у вас также есть поддержка фрагментов.

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

Отчет об ошибках

Посмотрим правде в глаза, мы все любим хорошее, console.log('Uh oh, if you reached here, you better run.')а иногда это прекрасно работает, поэтому, если вы не решаетесь отойти слишком далеко от него, по крайней мере, добавьте немного логов в ваши журналы с помощью отладки Visionmedia .

Интерактивная отладка

Как бы удобна ни была запись в журнал консоли, для профессиональной отладки вам нужно закатать рукава и застрять. Установите точки останова, пошагово просматривайте код, осмотрите области видимости и переменные, чтобы увидеть, что вызывает такое странное поведение. Как уже упоминали другие, узел-инспектор действительно является коленями пчел. Он делает все, что вы можете делать со встроенным отладчиком, но с помощью знакомого интерфейса Chrome DevTools. Если, как и я, вы используете Webstorm , то вот вам полезное руководство по отладке.

Следы стека

По умолчанию мы не можем проследить последовательность операций в разных циклах цикла событий (тики). Чтобы обойти это, взгляните на Longjohn (но не в производстве!).

Утечки памяти

С Node.js мы можем ожидать, что процесс сервера будет работать в течение значительного времени. Что вы делаете, если думаете, что произошли некоторые неприятные утечки? Используйте heapdump и Chrome DevTools, чтобы сравнить некоторые снимки и увидеть, что меняется.

Для некоторых полезных статей, проверьте

• RisingStack - отладка приложений Node.js
• Отличная статья Дэвида Марка Клемента из nearForm

Если вы хотите посмотреть видео,

• Netflix JS Talks - Отладка Node.js в производстве
• Интересное видео от рабочей группы по трассировке и отладке node.js
• Действительно информативное 15-минутное видео на узле-инспекторе

Какой бы путь вы ни выбрали, просто убедитесь, что вы понимаете, как вы отлаживаете

Больно
смотреть на свои проблемы и знать,
что ты сам и никто другой не сделал это

Софокл, Аякс

Theseus - это проект, разработанный компанией Adobe Research, который позволяет отлаживать код Node.js в их редакторе Open Source Brackets . Он имеет несколько интересных функций, таких как покрытие кода в реальном времени, обратная проверка, дерево асинхронных вызовов.

Инструменты Node.js для Visual Studio 2012 или 2013 включают отладчик. Обзор здесь гласит: «Инструменты Node.js для Visual Studio включают полную поддержку приложений отладки узлов». Будучи новичком в Node.js, но имея опыт работы с .NET, я обнаружил, что это дополнение является отличным способом отладки приложений Node.js.

Visual Studio Code имеет действительно хорошую поддержку отладки Node.js. Он бесплатный, с открытым исходным кодом и кроссплатформенный и работает на Linux, OS X и Windows.

Вы даже можете отлаживать задачи grunt и gulp , если вам нужно ...

Я написал другой подход к отладке кода Node.js, который стабилен и чрезвычайно прост. Он доступен по адресу https://github.com/sa/iron-node .

Кроссплатформенный визуальный отладчик с открытым исходным кодом.

Установка:

npm install iron-node -g;

Debug:

iron-node yourscript.js;

Если вы используете Atom IDE , вы можете установить node-debuggerпакет.

Использование Chrome версии 67.0.3396.62 (+)

1. Запустить приложение узла

узел --inspect-brk = 0.0.0.0: 9229 server.js (имя файла сервера js)

2. Просмотрите ваше приложение в Chrome, например, "localhost: port"
3. Откройте DevTools.
4. Нажмите значок узла рядом со значком адаптивного устройства.

Будет другое окно DevTools, которое будет появляться специально для отладки приложения узла.

Я создал небольшой инструмент под названием pry.js, который может вам помочь.

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

var pry = require('pryjs')

class FizzBuzz

  run: ->
    for i in [1..100]
      output = ''
      eval(pry.it) // magic
      output += "Fizz" if i % 3 is 0
      output += "Buzz" if i % 5 is 0
      console.log output || i

  bar: ->
    10

fizz = new FizzBuzz()
fizz.run()

В Node.js. есть встроенный клиент отладчика командной строки. В Cloud 9 IDE также есть довольно приятный (визуальный) отладчик .

Visual Studio Code будет работать для нас при отладке.

Я собрал короткий учебник по отладке Node.js по использованию инспектора узлов для тех, кто не знает, с чего начать.

Используйте Webstorm! Он идеально подходит для отладки приложений Node.js. Он имеет встроенный отладчик. Проверьте документы здесь: https://www.jetbrains.com/help/webstorm/2016.1/running-and-debugging-node-js.html

Запустите процесс вашего узла с флагом --inspect .

node --inspect index.js

а затем открыть chrome://inspectв хром. Нажмите на ссылку «Открыть выделенный DevTools для узла» или установите это расширение Chrome, чтобы легко открывать Chrome DevTools.

Для получения дополнительной информации обратитесь к этой ссылке

Если вам нужна мощная библиотека журналов для Node.js, лучше использовать Tracer https://github.com/baryon/tracer .

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

Предполагая, что на вашем компьютере установлен нод-инспектор (если нет, просто введите 'npm install -g node-inspector'), вам просто нужно выполнить:

node-inspector & node --debug-brk scriptFileName.js

И вставьте URI из командной строки в браузер WebKit (Chrome / Safari).

Просто для полноты:

PyCharm 3,0 + Node.js Плагин предлагает удивительный опыт разработки + бег + отладки .

IntelliJ прекрасно работает для Node.js.

Кроме того, IntelliJ хорошо поддерживает «Code Assistance».

Есть много возможностей ...

• узел включает в себя утилиту отладки
• Узел-инспектор
• Редакторы кода / IDE (см. Инструкции по отладке для одного из следующих)
  • Атом ,
  • VSCode
  • WebStorm
  • и более

Поддержка отладки часто реализуется с использованием протокола отладки v8 или более нового протокола отладки Chrome .

Существует новый проект Nodeclipse с открытым исходным кодом (в виде плагина Eclipse или Enide Studio ):

Nodeclipse стал № 1 в топ-10 новых плагинов Eclipse на 2013 год . Он использует модифицированный отладчик V8 (из Google Chrome Developer Tools для Java).

Nodeclipse - это бесплатное программное обеспечение с открытым исходным кодом, выпускаемое в начале каждого месяца .

NetBeans IDE была Node.js поддержки начиная с версии 8.1 :

<...>

Новая особенность

Node.js Разработка приложений

• Мастер создания нового Node.js
• Новый мастер Node.js Express
• Улучшенный редактор JavaScript
• Новая поддержка для запуска приложений Node.js
• Новая поддержка для отладки приложений Node.js.

<...>

Дополнительные ссылки:

1. NetBeans Wiki / NewAndNoteworthyNB81 .
2. Приложение Node.js Express в среде IDE NetBeans, Geertjan-Oracle .

Используйте эти команды

DEBUG_LEVEL=all node file.js
DEBUG=* node file.js
node file.js --inspect

ndb - улучшенный опыт отладки для Node.js, включенный Chrome DevTools

https://github.com/GoogleChromeLabs/ndb

Быстрый и грязный способ отладки небольших скриптов Node.js с помощью вашего любимого отладчика браузера - использовать browserify . Обратите внимание, что этот подход не работает с любыми приложениями, которые требуют собственных библиотек ввода / вывода, но он достаточно хорош для большинства небольших сценариев.

$ npm install -g browserify

Теперь переместите все ваши var x = requires('x')звонки в requires.jsфайл и запустите:

$ browserify requires.js -s window -o bundle.js

(Недостатком здесь является то, что вы должны либо перемещать, либо комментировать requiresфайлы).

Включите bundle.jsв файл HTML примерно так:

<script type="text/javascript" src="bundle.js"></script>

Теперь загрузите файл в ваш браузер и нажмите F12и отладьте в браузере.