Урок 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.
- Ошибки нужно логировать с контекстом.
Документация
Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.