re:re:actable
Урок 011 минута чтения

Как обрабатывать ошибки в Node.js?

На этой странице
Кратко

Ошибки в Node.js обрабатывают по-разному в зависимости от стиля кода: try/catch для async/await, .catch() для Promise, первый аргумент callback для callback API и middleware ошибок во фреймворках.

Вопрос

Как правильно обрабатывать ошибки в Node.js в синхронном и асинхронном коде?

Синхронные ошибки

try {
  const data = JSON.parse('{ bad json }');
  console.log(data);
} catch (error) {
  console.error('JSON не распарсился:', error.message);
}

Ошибки в async/await

import { readFile } from 'node:fs/promises';
 
try {
  const text = await readFile('missing.txt', 'utf8');
  console.log(text);
} catch (error) {
  console.error('Файл не прочитан:', error.message);
}

Ошибки в Promise

readFile('missing.txt', 'utf8')
  .then(console.log)
  .catch((error) => {
    console.error(error.message);
  });

Ошибки в HTTP-сервере

В обработчике запроса нельзя отправлять пользователю внутренние детали ошибки.

try {
  const user = await getUser();
  res.end(JSON.stringify(user));
} catch (error) {
  console.error(error);
  res.statusCode = 500;
  res.end(JSON.stringify({ message: 'Internal server error' }));
}

Что важно помнить

  • Синхронные ошибки и await ловит try/catch; промисы без await — только .catch().
  • Бросайте экземпляры Error, а не строки — так сохраняется stack trace.
  • Используйте cause для цепочки ошибок: new Error('Не удалось сохранить', { cause: err }).
  • Разделяйте операционные ошибки (сеть, валидация) и ошибки программиста (баги).

Мини-шпаргалка

  • throw создает исключение.
  • try/catch ловит sync ошибки и ошибки из await.
  • Promise-ошибки ловятся через .catch().
  • В HTTP не раскрывай пользователю stack trace.
  • Ошибки нужно логировать с контекстом.

Документация

Node.js: Errors, MDN: Error cause.

Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.

Поиск

Поиск по урокам