Урок 041 минута чтения
Как отлаживать Node.js приложение?
На этой странице
Кратко
Node.js-приложение можно отлаживать через логи, stack trace, встроенный inspector, breakpoints в IDE, флаг --inspect, профилирование и тесты, которые воспроизводят проблему.
Вопрос
Как отлаживать Node.js-приложение?
Логи
Самый простой инструмент - осмысленные логи.
console.log('request received', {
method: req.method,
url: req.url,
});Для production обычно используют логгеры вроде pino или winston, чтобы получать структурированные JSON-логи.
Stack trace
Ошибка содержит стек вызовов:
try {
await run();
} catch (error) {
console.error(error.stack);
}Стек помогает понять, где ошибка была создана и через какие вызовы прошла.
Inspector
Node.js можно запустить в режиме отладки:
node --inspect app.jsДля остановки на первой строке:
node --inspect-brk app.jsПосле этого можно подключиться через Chrome DevTools или IDE и ставить breakpoints.
Debug-подход
Хорошая последовательность:
- Воспроизвести баг стабильно.
- Сузить место ошибки.
- Проверить входные данные.
- Проверить состояние перед ошибкой.
- Написать тест на найденный сценарий.
Что важно помнить
node --inspect(или--inspect-brkс паузой на первой строке) открывает отладчик для Chrome DevTools и VS Code.- Инструкция
debugger;ставит точку останова при подключенном отладчике. --watchперезапускает процесс при изменении файлов.- Не открывайте inspector-порт наружу в production — он дает полный доступ к процессу.
Мини-шпаргалка
console.logполезен, но не должен быть единственным инструментом.error.stackпоказывает цепочку вызовов.node --inspectвключает debugger.node --inspect-brkостанавливает выполнение на старте.- Лучший фикс бага часто начинается с воспроизводящего теста.
Документация
Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.