Node.js / 系统课时

使用 async 与 await

使用 async 与 await

async 与 await 让 Promise 流程按接近同步代码的顺序书写,同时仍保留 Node.js 的异步执行方式。本课会处理返回值、等待行为、并行任务和异常传播,并给出可以直接运行的结构,避免把独立 I/O 无意写成串行。

学习目标

  • 理解 async 函数返回值与 Promise 之间的关系
  • 使用 await 获取异步结果,并判断代码何时真正暂停
  • 用 Promise.all 并行等待独立任务,并用 try...catch 处理拒绝

async 函数始终返回 Promise

只要函数声明前有 async,调用结果就是 Promise。函数直接 return 42 等价于返回一个以 42 成功的 Promise;函数内部抛出异常则等价于返回一个被拒绝的 Promise。因此调用者必须使用 await、then 或继续 return 这个 Promise。

js
async function answer() {
  return 42;
}

const result = answer();
console.log(result instanceof Promise);

result.then((value) => {
  console.log(value);
});

预期输出

text
true
42

这条规则会影响函数边界。若 loadPage() 内部调用 await loadData(),那么 loadPage() 本身也返回 Promise;上层如果需要等它完成,就必须继续 await loadPage() 或返回它,不能因为函数内部看起来像同步代码就忽略异步结果。

await 如何暂停和恢复

执行到 await promise 时,当前 async 函数会暂停后续语句,并把控制权交还给调用者;它不会阻塞整个 Node.js 进程。等 Promise 确定状态后,函数后续部分会通过 Promise reaction,也就是微任务,获得继续执行的机会。

async await 暂停与恢复流程

下面的 main 只有在 loadValue 返回的 Promise 成功后才执行下一条日志。setTimeout 的 20 毫秒是最短等待时间,实际调度可能略长,因此不要把定时器当作高精度计时器。

js
function loadValue(value, delayMs) {
  return new Promise((resolve) => {
    setTimeout(() => resolve(value), delayMs);
  });
}

async function main() {
  console.log('start');
  const user = await loadValue({ id: 7, name: 'Ada' }, 20);
  console.log(user.name);
  console.log('end');
}

main().catch((error) => {
  console.error(error);
});

预期输出

text
start
Ada
end

把入口调用写成 main().catch(...) 还能接住没有在 main 内处理的拒绝。在 CommonJS 文件中,这种入口形式也比直接使用顶层 await 更通用;顶层 await 应用于 ECMAScript Module,例如 .mjs 文件或声明了 "type": "module" 的项目。

并行等待与错误处理

连续写两个 await 会形成串行等待。如果两个 I/O 没有依赖关系,例如一个需要至少 80 ms、另一个需要至少 120 ms,串行方式理论等待下限约为 200 ms;同时启动后再用 Promise.all 等待,理论下限接近较慢任务的 120 ms,另加实际调度开销。

下面同时启动资料和权限查询,再演示一个被拒绝的 Promise 如何直接变成 try...catch 可以捕获的异常。

js
function task(name, delayMs, shouldFail = false) {
  return new Promise((resolve, reject) => {
    setTimeout(() => {
      if (shouldFail) {
        reject(new Error(`${name} failed`));
        return;
      }

      resolve(name);
    }, delayMs);
  });
}

async function main() {
  try {
    const [profile, permissions] = await Promise.all([
      task('profile', 20),
      task('permissions', 10)
    ]);

    console.log(`${profile}+${permissions}`);

    await task('payment', 5, true);
    console.log('unreachable');
  } catch (error) {
    console.log(`caught: ${error.message}`);
  }
}

main();

预期输出

text
profile+permissions
caught: payment failed

Promise.all 返回数组的顺序仍由输入位置决定,所以权限任务即使先完成,解构结果也仍是 [profile, permissions]。只有后一项确实依赖前一项结果时,才应该写成连续 await,例如必须先获得用户 ID,才能按该 ID 查询订单。

如果错误可以在当前层恢复,就在当前 try...catch 中处理;如果当前函数不知道该如何恢复,应让异常继续向上抛出。不要只写空的 catch 吞掉失败,否则调用者会误以为操作已经正常完成。

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

目录与阅读设置

阅读设置

17

记录一个想法

使用 async 与 await

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

登录哪都通