Node.js / 系统课时
使用 Promise
使用 Promise
Promise 用来表示一个现在还没有结果、但未来会成功或失败的异步操作。本课会把状态变化、链式返回、错误传播和多任务组合串成一套可运行写法,读完后可以直接在 Node.js 中组织文件、网络或定时器等异步流程。
学习目标
- 区分 Promise 的
pending、fulfilled和rejected三种状态 - 使用
then、catch、finally组成可继续返回结果的异步链 - 根据任务依赖关系选择
Promise.all或Promise.allSettled
Promise 的三种状态
一个 Promise 创建后从 pending 开始,只能转变一次:调用 resolve(value) 后进入 fulfilled,调用 reject(error) 后进入 rejected。状态一旦确定就不会再次改变,后续重复调用 resolve 或 reject 都不会覆盖第一次结果。
| 状态 | 含义 | 后续处理 |
|---|---|---|
pending |
操作尚未完成 | 等待状态确定 |
fulfilled |
操作成功 | 由 then 接收结果 |
rejected |
操作失败 | 由 catch 或拒绝处理函数接收错误 |

new Promise(executor) 的 executor 会在创建 Promise 时立即同步执行,真正异步的是其中启动的 I/O、定时器等工作。因此不要把 Promise 构造器理解成“自动把整段代码放到后台执行”。
链式调用与错误捕获
then 不会修改原 Promise,而是返回一个新的 Promise。处理函数返回普通值时,新 Promise 会以该值成功;返回另一个 Promise 时,后续链会等待它;处理函数抛出异常时,新 Promise 会进入拒绝状态,并沿链寻找最近的 catch。
下面保存为 promise-chain.js,直接用 Node.js 运行。示例先成功取得资料,再故意抛出错误,观察错误如何跳过后续成功路径并进入 catch。
function loadProfile(id) {
return new Promise((resolve, reject) => {
setTimeout(() => {
if (id !== 7) {
reject(new Error('user not found'));
return;
}
resolve({ id, name: 'Ada' });
}, 10);
});
}
loadProfile(7)
.then((profile) => ({
...profile,
label: profile.name.toUpperCase()
}))
.then((profile) => {
console.log(profile.label);
throw new Error('avatar unavailable');
})
.catch((error) => {
console.log(`caught: ${error.message}`);
})
.finally(() => {
console.log('done');
});预期输出
ADA
caught: avatar unavailable
donefinally 适合释放连接、删除临时文件或关闭加载状态,它通常不负责修改业务结果。尤其要注意在 then 中继续调用异步函数时必须 return 该 Promise,否则下一层会立刻得到 undefined,也无法正确等待内部任务。
组合多个异步结果
多个互不依赖的异步操作可以同时启动。Promise.all 会等待全部成功,并按输入顺序返回结果;其中任意一个 Promise 拒绝时,组合 Promise 会立即进入拒绝状态。需要收集每个任务最终状态时,则使用 Promise.allSettled。
const slow = new Promise((resolve) => {
setTimeout(() => resolve('database'), 20);
});
const fast = Promise.resolve('cache');
Promise.all([slow, fast])
.then((values) => {
console.log(values.join(','));
return Promise.allSettled([
Promise.resolve('primary'),
Promise.reject(new Error('backup offline'))
]);
})
.then((results) => {
console.log(results.map((item) => item.status).join(','));
});预期输出
database,cache
fulfilled,rejected即使 fast 更早完成,Promise.all([slow, fast]) 的结果仍按照输入位置排列为 database,cache。如果后续逻辑要求“所有请求都成功才能继续”,使用 Promise.all;如果批量任务允许部分失败,例如一次检查 20 个 URL 并生成完整报告,则 Promise.allSettled 更合适。
容易写错的边界
最常见的问题是创建了 Promise 却没有把它返回给调用者。例如在 then 中执行 saveUser(user); 而不写 return saveUser(user);,后续步骤就无法等待保存完成。需要串行依赖时,应让每一层明确返回下一项异步工作。
另一个边界是把“已经启动”误认为“已经成功”。Promise 对象本身只是异步结果的容器,真正的成功值必须通过 then、await 或组合 API 获取;错误也应在链尾至少有一个 catch,否则拒绝可能演变成未处理的 Promise rejection。