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。
async function answer() {
return 42;
}
const result = answer();
console.log(result instanceof Promise);
result.then((value) => {
console.log(value);
});预期输出
true
42这条规则会影响函数边界。若 loadPage() 内部调用 await loadData(),那么 loadPage() 本身也返回 Promise;上层如果需要等它完成,就必须继续 await loadPage() 或返回它,不能因为函数内部看起来像同步代码就忽略异步结果。
await 如何暂停和恢复
执行到 await promise 时,当前 async 函数会暂停后续语句,并把控制权交还给调用者;它不会阻塞整个 Node.js 进程。等 Promise 确定状态后,函数后续部分会通过 Promise reaction,也就是微任务,获得继续执行的机会。

下面的 main 只有在 loadValue 返回的 Promise 成功后才执行下一条日志。setTimeout 的 20 毫秒是最短等待时间,实际调度可能略长,因此不要把定时器当作高精度计时器。
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);
});预期输出
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 可以捕获的异常。
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();预期输出
profile+permissions
caught: payment failedPromise.all 返回数组的顺序仍由输入位置决定,所以权限任务即使先完成,解构结果也仍是 [profile, permissions]。只有后一项确实依赖前一项结果时,才应该写成连续 await,例如必须先获得用户 ID,才能按该 ID 查询订单。
如果错误可以在当前层恢复,就在当前 try...catch 中处理;如果当前函数不知道该如何恢复,应让异常继续向上抛出。不要只写空的 catch 吞掉失败,否则调用者会误以为操作已经正常完成。