Node.js / 系统课时
使用回调函数
使用回调函数
Node.js 的许多异步 API 会在操作完成后调用你传入的函数,并把错误与结果交回来。本课用文件读取演示最常见的错误优先回调约定,完成成功、失败两个分支,并避免错误发生后代码继续向下执行。
学习目标
- 看懂
callback(error, value)的错误优先参数约定 - 正确处理成功结果与
Error对象 - 用提前
return避免错误分支继续执行
看懂错误优先回调约定
典型 Node.js 回调写成 callback(error, value):第一个参数表示错误,第二个参数表示成功结果。成功时通常得到 null 错误;失败时第一个参数是 Error 对象,此时不要继续使用结果值。
someAsyncOperation((error, value) => {
if (error) {
// 失败路径在这里结束,避免继续处理无效 value
return handleError(error);
}
handleValue(value);
});这段是片段示例,其中 someAsyncOperation、handleError 和 handleValue 代表调用方已有的函数。需要记住的是参数顺序和错误分支的提前返回,而不是这几个示例名称。
用 fs.readFile 处理成功和失败
下面保存为 callback-demo.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()}`);
});运行成功路径:
node callback-demo.js预期输出:
读取成功: hello callbackfs.readFile() 不会阻塞当前 JavaScript 调用栈等待磁盘完成;读取结束后,Node.js 再执行回调。这里显式传入 utf8,因此 data 是字符串;省略编码时得到的是 Buffer。
验证错误分支是否真的结束
传入一个不存在的文件,检查程序是否只报告错误,而没有继续执行成功分支:
node callback-demo.js missing.txt预期输出:
读取失败: ENOENT实际系统中的错误对象还包含 message、path 等信息,其中路径会随运行目录变化,因此示例只输出稳定的 error.code。ENOENT 表示目标路径不存在。
错误处理里常见的错误写法是只写 if (error) console.error(error),随后继续访问 data。正确做法是 return、throw,或把错误传给更上层的回调,确保成功逻辑不会在失败后继续运行。
回调实现要守住一次调用边界
自己封装异步函数时,回调应当在一次操作中调用一次。下面的 readTitle 把文件读取结果转换成第一行,并把底层错误原样向上传递:
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);
});预期输出:
Node.js callbacks这里错误分支使用 return callback(error),成功分支使用 callback(null, title),两条路径互斥,因此不会出现一次操作触发两次回调的问题。封装 Node 风格函数时,保持这一约定可以让调用方使用统一的错误处理方式。