Symbol.iterator与Symbol.asyncIterator详解

Symbol.iterator 和 Symbol.asyncIterator 是 JavaScript 中赋予对象“可遍历能力”的核心机制：前者让对象支持同步迭代（如 for...of），通过返回带 next() 方法的迭代器实现逐值获取；后者则扩展至异步场景（如 for await...of），其 next() 返回 Promise，完美适配流式、分页或延迟加载等异步数据源——二者共同让自定义对象无缝融入现代 JavaScript 的遍历语法，真正实现“按需取值”与“按需等待”的优雅统一。

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 

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

• 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学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！