Отладчик

Node.js включает утилиту отладки вне процесса, доступную через протокол TCP и встроенный клиент отладки. Чтобы использовать её, запустите Node.js с аргументом debug, за которым следует путь к сценарию, который необходимо отладить; появится сообщение, указывающее на успешный запуск отладчика:

$ node debug myscript.js
< debugger listening on port 5858
connecting... ok
break in /home/indutny/Code/git/indutny/myscript.js:1
  1 x = 5;
  2 setTimeout(() => {
  3   debugger;
debug>

Клиент отладки Node.js не является полноценным отладчиком, но простые шаги и инспекция возможны.

Вставка инструкции debugger; в исходный код сценария позволит установить точку останова в этом месте кода:

// myscript.js
x = 5;
setTimeout(() => {
  debugger;
  console.log('world');
}, 1000);
console.log('hello');

После запуска отладчика точка останова будет достигнута на строке 4:

$ node debug myscript.js
< debugger listening on port 5858
connecting... ok
break in /home/indutny/Code/git/indutny/myscript.js:1
  1 x = 5;
  2 setTimeout(() => {
  3   debugger;
debug> cont
< hello
break in /home/indutny/Code/git/indutny/myscript.js:3
  1 x = 5;
  2 setTimeout(() => {
  3   debugger;
  4   console.log('world');
  5 }, 1000);
debug> next
break in /home/indutny/Code/git/indutny/myscript.js:4
  2 setTimeout(() => {
  3   debugger;
  4   console.log('world');
  5 }, 1000);
  6 console.log('hello');
debug> repl
Press Ctrl + C to leave debug repl
> x
5
> 2+2
4
debug> next
< world
break in /home/indutny/Code/git/indutny/myscript.js:5
  3   debugger;
  4   console.log('world');
  5 }, 1000);
  6 console.log('hello');
  7
debug> quit

Команда repl позволяет удалённо оценивать код. Команда next переходит к следующей строке. Введите help, чтобы увидеть другие доступные команды.

Наблюдаемые значения

Возможна отслежка значений выражений и переменных во время отладки. На каждой точке останова каждое выражение из списка наблюдаемых значений будет вычислено в текущем контексте и отображено непосредственно перед списком исходного кода точки останова.

Чтобы начать наблюдение за выражением, введите watch('my_expression'). Команда watchers выведет активные наблюдаемые значения. Чтобы удалить наблюдаемое значение, введите unwatch('my_expression').

Справочник по командам

Шаги

Точки останова

Также возможно установить точку останова в файле (модуле), который ещё не загружен:

$ node debug test/fixtures/break-in-module/main.js
< debugger listening on port 5858
connecting to port 5858... ok
break in test/fixtures/break-in-module/main.js:1
  1 var mod = require('./mod.js');
  2 mod.hello();
  3 mod.hello();
debug> setBreakpoint('mod.js', 23)
Warning: script 'mod.js' was not loaded yet.
  1 var mod = require('./mod.js');
  2 mod.hello();
  3 mod.hello();
debug> c
break in test/fixtures/break-in-module/mod.js:23
 21
 22 exports.hello = () => {
 23   return 'hello from module';
 24 };
 25
debug>

Информация

Управление выполнением

Разное

Расширенное использование

Альтернативный способ включения и доступа к отладчику — запуск Node.js с флагом командной строки --debug или отправка сигнала существующему процессу Node.js с помощью SIGUSR1.

После того, как процесс переведён в режим отладки этим способом, к нему можно получить доступ с помощью отладчика Node.js, подключившись к pid работающего процесса или по ссылке на URI отслеживающего отладчика:

• node debug -p <pid> - Подключается к процессу через pid
• node debug <URI> - Подключается к процессу через URI, например, localhost:5858