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 或拒绝处理函数接收错误

Promise 状态变化与处理链路

new Promise(executor) 的 executor 会在创建 Promise 时立即同步执行,真正异步的是其中启动的 I/O、定时器等工作。因此不要把 Promise 构造器理解成“自动把整段代码放到后台执行”。

链式调用与错误捕获

then 不会修改原 Promise,而是返回一个新的 Promise。处理函数返回普通值时,新 Promise 会以该值成功;返回另一个 Promise 时,后续链会等待它;处理函数抛出异常时,新 Promise 会进入拒绝状态,并沿链寻找最近的 catch。

下面保存为 promise-chain.js,直接用 Node.js 运行。示例先成功取得资料,再故意抛出错误,观察错误如何跳过后续成功路径并进入 catch。

js
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');
  });

预期输出

text
ADA
caught: avatar unavailable
done

finally 适合释放连接、删除临时文件或关闭加载状态,它通常不负责修改业务结果。尤其要注意在 then 中继续调用异步函数时必须 return 该 Promise,否则下一层会立刻得到 undefined,也无法正确等待内部任务。

组合多个异步结果

多个互不依赖的异步操作可以同时启动。Promise.all 会等待全部成功,并按输入顺序返回结果;其中任意一个 Promise 拒绝时,组合 Promise 会立即进入拒绝状态。需要收集每个任务最终状态时,则使用 Promise.allSettled。

js
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(','));
  });

预期输出

text
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。

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

目录与阅读设置

阅读设置

17

记录一个想法

使用 Promise

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

登录哪都通