Урок 021 минута чтения
Что такое error-first callback?
На этой странице
Кратко
Error-first callback - классический Node.js-паттерн, где первым аргументом callback-функции передается ошибка, а следующими аргументами - успешный результат.
Вопрос
Что такое error-first callback и как перевести такой API на промисы?
Формат
operation((error, result) => {
if (error) {
// обработка ошибки
return;
}
// работа с result
});Первый аргумент зарезервирован под ошибку. Если ошибки нет, обычно передается null.
Пример с fs
import fs from 'node:fs';
fs.readFile('notes.txt', 'utf8', (error, text) => {
if (error) {
console.error('Ошибка чтения:', error.message);
return;
}
console.log(text);
});Почему этот паттерн появился?
В раннем Node.js Promise еще не были стандартным способом писать асинхронный код. Callback API позволял передавать функцию, которую Node.js вызовет после завершения операции.
Как перейти к Promise?
Многие callback-функции можно обернуть через promisify.
import fs from 'node:fs';
import { promisify } from 'node:util';
const readFile = promisify(fs.readFile);
const text = await readFile('notes.txt', 'utf8');Но для fs чаще проще сразу взять node:fs/promises.
Что важно помнить
- Первый аргумент callback-а — ошибка или
null, следующие — результат. - Всегда проверяйте ошибку первой и делайте
returnпосле ее обработки. util.promisifyпревращает callback API в функцию, возвращающую Promise.- Callback должен вызываться ровно один раз — двойной вызов приводит к трудноуловимым багам.
Мини-шпаргалка
- Первый аргумент callback - ошибка.
- Если ошибки нет, первым аргументом обычно будет
null. - После обработки ошибки делай
return, чтобы не продолжить выполнение. - Это старый, но все еще распространенный Node.js-паттерн.
- В новом коде чаще используют Promise и
async/await.
Документация
Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.