异步迭代是通过 for await...of 消费异步可迭代对象的机制，适用于逐步获取异步数据的场景。它要求对象实现 Symbol.asyncIterator 方法，常用于异步生成器、流处理等情境，需在 async 函数中使用，不能直接用于普通 Promise 数组，但可通过包装转为异步可迭代对象，从而实现逐个等待值的优雅流式处理逻辑。
在处理异步数据流时，JavaScript 提供了 for await...of 循环语法，让开发者可以像遍历同步可迭代对象一样，优雅地消费异步生成的数据。它适用于异步可迭代对象（async iterable），比如从网络流、文件读取或异步生成器中逐步获取值的场景。
什么是异步迭代？
异步迭代是一种允许你逐个获取异步结果的机制。与普通 for...of 遍历同步值不同，for await...of 用于等待每个异步值的完成后再继续下一轮循环。
要使用 for await...of，被遍历的对象必须是异步可迭代对象，即实现了 Symbol.asyncIterator 方法，并返回一个带有 next() 方法且返回 Promise 的对象。
如何使用 for-await-of
假设有一个异步生成器函数，每次 yield 一个延迟返回的值：
立即学习“Java免费学习笔记（深入）”；
async function* asyncGenerator() {yield await new Promise(resolve => setTimeout(() => resolve('a'), 1000));
yield await new Promise(resolve => setTimeout(() => resolve('b'), 1000));
yield await new Promise(resolve => setTimeout(() => resolve('c'), 1000));
}
你可以用 for await...of 来按顺序消费这些值：
(async () => {for await (const value of asyncGenerator()) {
console.log(value); // 每隔一秒输出 'a', 'b', 'c'
}
})();
这个循环会自动等待每一个异步 yield 完成，无需手动调用 .next() 或处理 Promise 链。
实际应用场景
for await...of 特别适合以下场景：
- 读取大型文件流时，逐块处理数据
- 接收 WebSocket 或 EventSource 消息流
- 从数据库游标中异步提取记录
- 处理分页 API 响应，每次请求下一页
例如，在 Node.js 中读取可读流（ReadableStream）时，可以通过异步迭代来简化代码：
const readableStream = getStreamSomehow();readableStream[Symbol.asyncIterator] = function() {
return this;
};
for await (const chunk of readableStream) {
console.log('Received:', chunk);
}
注意事项和限制
使用 for await...of 时需要注意几点：
- 只能在 async 函数内部使用
- 不能中断后恢复：一旦 break 或抛出异常，后续迭代将停止
- 不适用于普通数组：如果数组包含 Promise，应使用 Promise.all() 或 map + await 更合适
- 需确保目标对象支持异步迭代协议，否则会抛错
如果你有一个 Promise 数组并想逐个 await，可以用包装方式使其异步可迭代：
async function* makeAsyncIterable(array) {for (const item of array) {
yield await item;
}
}
基本上就这些。for await...of 是处理异步数据流的强大工具，结合异步生成器，能写出清晰、可读性强的流式处理逻辑。关键在于理解何时使用它——当你面对的是“随时间推移逐步到达”的数据时，它就是最佳选择。
