Symbol.iterator与Symbol.asyncIterator详解

**深入理解 JavaScript 迭代器：Symbol.iterator 与 Symbol.asyncIterator 的妙用与区别** 在 JavaScript 中，`Symbol.iterator` 和 `Symbol.asyncIterator` 是两个至关重要的内置符号，它们分别用于定义对象的同步和异步迭代行为。`Symbol.iterator` 赋予对象使用 `for...of` 循环的能力，通过返回一个包含 `next()` 方法的迭代器对象，实现对数据的逐个同步访问。而 `Symbol.asyncIterator` 则专注于异步数据流的处理，它返回的迭代器对象的 `next()` 方法返回一个 Promise，配合 `for await...of` 循环，可以优雅地处理诸如文件读取、网络请求等异步操作。本文将详细解析这两个符号的作用、用法以及它们之间的关键区别，助你更好地掌握 JavaScript 的迭代器机制，提升代码的效率和可读性。

Symbol.iterator用于同步遍历，需返回具有next方法的迭代器对象，支持for...of循环；Symbol.asyncIterator用于异步遍历，返回Promise形式的{value, done}结果，支持for await...of循环。

Symbol.iterator 和 Symbol.asyncIterator 是 JavaScript 中用于定义对象遍历行为的特殊符号，它们决定了对象如何被 for...of 循环或异步循环处理。

Symbol.iterator：控制同步遍历

Symbol.iterator 定义一个对象的同步迭代器。只要一个对象实现了这个方法，就可以在 for...of 中使用。

该方法必须返回一个迭代器对象，这个对象有 next() 方法，每次调用返回 { value, done } 格式的结果。

• 数组、字符串、Map、Set 都内置了 Symbol.iterator，所以能被 for...of 遍历
• 可以手动为对象添加 Symbol.iterator 来支持遍历

例如：

const myIterable = {
  data: [1, 2, 3],
  [Symbol.iterator]() {
    let index = 0;
    return {
      next: () => {
        if (index 

<h3>Symbol.asyncIterator：支持异步遍历</h3>
<p>Symbol.asyncIterator 用于定义异步迭代器，适用于数据是逐步异步获取的场景，比如读取流、分页数据等。</p>
<p>它返回一个对象，其 next() 方法返回 Promise，resolve 结果为 { value, done }。</p>
<p>需要用 <strong>for await...of</strong> 来遍历。</p>
<font>典型应用：</font>

• Node.js 中的可读流（Readable Stream）支持 Symbol.asyncIterator
• 自定义异步数据源，如逐条获取数据库记录

示例：

const myAsyncIterable = {
  async *[Symbol.asyncIterator]() {
    for (let i = 1; i  setTimeout(resolve, 1000));
      yield i;
    }
  }
};

for await (const item of myAsyncIterable) {
  console.log(item); // 每秒输出 1, 2, 3
}

基本上就这些。Symbol.iterator 处理“我能怎么被一步步取值”，而 Symbol.asyncIterator 解决“我怎么被一步步异步取值”。两者让自定义对象也能自然融入 for...of 或 for await...of 的语法中。区别在于是否涉及等待。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《Symbol.iterator与Symbol.asyncIterator详解》文章吧，也可关注golang学习网公众号了解相关技术文章。