for-await-of 解决传统 for-of 无法处理异步迭代器的问题，自动等待每个 Promise 完成；用法如 async function* fetchUsers() { for (let i = 1; i
JavaScript 的 for-await-of 循环是专为遍历异步可迭代对象（如异步生成器、实现了 [Symbol.asyncIterator]() 的对象）设计的语法，它让处理异步数据流变得像写同步代码一样简洁自然。
for-await-of 解决什么问题？
传统 for-of 只能消费同步迭代器，遇到返回 Promise 的迭代项（比如逐个读取文件、分页请求 API、监听事件流）时会出错或得不到预期结果。for-await-of 自动等待每个迭代项的 Promise 完成，再进入下一轮循环，避免手动写 await + while 或嵌套 then。
它怎么用？看一个典型例子
假设你有一个异步生成器，模拟按需加载用户列表：
async function* fetchUsers() {
for (let i = 1; i <= 3; i++) {
const res = await fetch(`/api/user/${i}`);
yield await res.json();
}
}
// 使用 for-await-of 消费
for await (const user of fetchUsers()) {
console.log(user.name); // 自动等待每个 fetch 完成后再打印
}
这里每轮循环都等前一个 yield 的 Promise settle 后才继续，顺序清晰、错误可控。
立即学习“Java免费学习笔记（深入）”；
哪些对象能被 for-await-of 遍历？
必须满足“异步可迭代协议”，即对象有 [Symbol.asyncIterator]() 方法，且该方法返回一个具有 next() 方法的对象，而 next() 返回 Promise，其 resolve 值带 value 和 done 属性。常见支持类型包括：
- 异步生成器函数（
async function*）返回的迭代器 - Node.js 中的
ReadableStream（如fs.createReadStream在 Node 18+） - 手动实现
[Symbol.asyncIterator]的自定义类（例如封装 WebSocket 消息流）
错误处理和提前退出要注意什么？
for-await-of 内部会把迭代中抛出的异常或 Promise rejection 向上传播，所以推荐用 try...catch 包裹：
try {
for await (const data of asyncDataStream()) {
process(data);
}
} catch (err) {
console.error("某次异步操作失败", err);
}另外，循环中使用 break、return 或 throw 会触发迭代器的 return() 方法（如果实现），可用于清理资源（如取消未完成的请求、关闭连接）。
基本上就这些 —— for-await-of 不复杂但容易忽略它的适用边界：它不是万能的“异步 for 循环”，只对真正符合异步迭代协议的数据源有效；普通数组、Promise.all 结果、或未正确实现 asyncIterator 的对象都不能直接用它遍历。
