Node.js / 系统课时

使用回调函数

使用回调函数

Node.js 的许多异步 API 会在操作完成后调用你传入的函数,并把错误与结果交回来。本课用文件读取演示最常见的错误优先回调约定,完成成功、失败两个分支,并避免错误发生后代码继续向下执行。

学习目标

  • 看懂 callback(error, value) 的错误优先参数约定
  • 正确处理成功结果与 Error 对象
  • 用提前 return 避免错误分支继续执行

看懂错误优先回调约定

典型 Node.js 回调写成 callback(error, value):第一个参数表示错误,第二个参数表示成功结果。成功时通常得到 null 错误;失败时第一个参数是 Error 对象,此时不要继续使用结果值。

js
someAsyncOperation((error, value) => {
  if (error) {
    // 失败路径在这里结束,避免继续处理无效 value
    return handleError(error);
  }

  handleValue(value);
});

这段是片段示例,其中 someAsyncOperation、handleError 和 handleValue 代表调用方已有的函数。需要记住的是参数顺序和错误分支的提前返回,而不是这几个示例名称。

用 fs.readFile 处理成功和失败

下面保存为 callback-demo.js。没有传入文件名时,程序先创建一个测试文件再异步读取;传入其他文件名时则直接尝试读取,因此可以同时验证成功和错误路径。

js
const fs = require('node:fs');

const fileName = process.argv[2] ?? 'message.txt';

if (!process.argv[2]) {
  fs.writeFileSync(fileName, 'hello callback\n', 'utf8');
}

fs.readFile(fileName, 'utf8', (error, data) => {
  // 错误分支必须结束当前回调,不能继续使用 data。
  if (error) {
    console.error(`读取失败: ${error.code}`);
    process.exitCode = 1;
    return;
  }

  console.log(`读取成功: ${data.trim()}`);
});

运行成功路径:

bash
node callback-demo.js

预期输出:

text
读取成功: hello callback

fs.readFile() 不会阻塞当前 JavaScript 调用栈等待磁盘完成;读取结束后,Node.js 再执行回调。这里显式传入 utf8,因此 data 是字符串;省略编码时得到的是 Buffer。

验证错误分支是否真的结束

传入一个不存在的文件,检查程序是否只报告错误,而没有继续执行成功分支:

bash
node callback-demo.js missing.txt

预期输出:

text
读取失败: ENOENT

实际系统中的错误对象还包含 message、path 等信息,其中路径会随运行目录变化,因此示例只输出稳定的 error.code。ENOENT 表示目标路径不存在。

错误处理里常见的错误写法是只写 if (error) console.error(error),随后继续访问 data。正确做法是 return、throw,或把错误传给更上层的回调,确保成功逻辑不会在失败后继续运行。

回调实现要守住一次调用边界

自己封装异步函数时,回调应当在一次操作中调用一次。下面的 readTitle 把文件读取结果转换成第一行,并把底层错误原样向上传递:

js
const fs = require('node:fs');

function readTitle(fileName, callback) {
  fs.readFile(fileName, 'utf8', (error, text) => {
    if (error) {
      return callback(error);
    }

    const title = text.split('\n')[0];
    callback(null, title);
  });
}

fs.writeFileSync('note.txt', 'Node.js callbacks\nsecond line', 'utf8');

readTitle('note.txt', (error, title) => {
  if (error) {
    console.error(error.code);
    return;
  }

  console.log(title);
});

预期输出:

text
Node.js callbacks

这里错误分支使用 return callback(error),成功分支使用 callback(null, title),两条路径互斥,因此不会出现一次操作触发两次回调的问题。封装 Node 风格函数时,保持这一约定可以让调用方使用统一的错误处理方式。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

使用回调函数

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通