re:re:actable
Урок 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.

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

Node.js: Error-first callbacks, Node.js: util.promisify.

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

Поиск

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