17370845950

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 终止迭代，否则会无限循环