ES9(ECMAScript 2018)新增 for await...of 语句和 Symbol.asyncIterator 协议,支持异步迭代器;异步迭代器的 next() 返回 Promise,需用 async function* 创建;适用于文件流、WebSocket、分页请求等逐步产生数据的场景。

ES9(即 ECMAScript 2018)是 JavaScript 的一个重要版本,它没有引入颠覆性语法,但补全了异步编程的关键能力——原生支持异步迭代器。核心新增就是 for await...of 语句和 [Symbol.asyncIterator] 协议,让遍历异步数据流变得像写同步代码一样自然。
什么是异步迭代器?
它不是普通迭代器的“升级版”,而是专为异步场景设计的一套新协议:
- 异步可迭代对象必须实现
[Symbol.asyncIterator]()方法,该方法返回一个异步迭代器 - 异步迭代器的
next()方法返回的是Promise,而不是直接的对象;这个 Promise 解析后才得到{ value, done } - 普通
for...of只能消费同步迭代器;for await...of才能安全等待每个 Promise 完成后再继续下一轮
怎么创建一个可被 for await...of 遍历的对象?
最常用也最推荐的方式是使用 异步生成器函数(async function*),它会自动返回符合协议的异步迭代器:
const asyncCounter = {
[Symbol.asyncIterator]: async function* () {
for (let i = 0; i < 3; i++) {
await new Promise(r => setTimeout(r, 500)); // 模拟异步延迟
yield i;
}
}
};
// 使用
(async () => {
for await (const num of asyncCounter) {
console.log(num); // 每隔 500ms 输出 0、1、2
}
})();
常见适用场景有哪些?
凡是“数据不是一次性到达,而是逐步产生”的情况,都适合用异步迭代器:
立即学习“Java免费学习笔记(深入)”;
-
读取文件流:比如用
fs.createReadStream,配合for await...of逐块处理大文件,不阻塞主线程 - 处理 WebSocket 或 EventSource 消息流:每来一条消息就 yield 一次,逻辑清晰不嵌套
-
分页请求 API:把多个
fetch请求放进数组,用for await...of依次等待响应并处理,顺序可控 - 数据库游标查询:Node.js 的某些驱动(如 MongoDB)已支持返回异步可迭代对象,方便流式读取结果集
注意几个易错点
避免踩坑,关键细节要清楚:
-
for await...of必须在async函数或顶层模块中使用,否则语法报错 - 数组本身不是异步可迭代的,
for await (x of [p1, p2, p3])是合法的,但它是按顺序等待每个 Promise,不是并发执行 - 如果想并发处理多个 Promise 并保持顺序,不能靠
for await...of,而应先await Promise.all(...);若想“谁先完成谁先处理”,可用for await (const p of promises) { await p }配合Promise.race思路 - 手动实现
[Symbol.asyncIterator]时,务必确保next()返回 Promise,并正确设置done: true终止迭代,否则会无限循环











