JavaScript迭代器使用教程：自定义可迭代对象

JavaScript迭代器的核心在于正确实现Symbol.iterator方法，它必须返回一个符合协议的迭代器对象（含无参next()方法，每次调用返回{value, done}结构），而自定义时极易因忽略done终止信号、状态未隔离或重复使用同一迭代器实例导致无限循环、undefined输出或二次遍历失效；文章不仅剖析了手写迭代器的关键细节与常见陷阱，还推荐用生成器函数（function*）大幅简化开发——它天然满足协议、自动管理状态，并支持倒序遍历、惰性求值等高级场景，同时明确指出for...of、展开运算符、Array.from等语法糖均依赖该接口，遇到“is not iterable”错误时应优先检查Symbol.iterator是否缺失或实现不当。

JavaScript 迭代器的核心是 Symbol.iterator 方法

一个对象只要实现了 [Symbol.iterator]() 方法，且该方法返回一个符合迭代器协议的对象（即有 next() 方法，返回 { value, done } 形式的对象），它就能被 for...of、Array.from、展开运算符等消费。

注意：不是所有带 next() 的对象都是合法迭代器——必须满足协议定义。常见错误是忘了返回 done: true 终止信号，导致无限循环或 undefined 值持续产出。

• next() 必须是无参函数（或只接受一个可选参数，如 yield* 场景，但自定义时通常不传）
• 首次调用 next() 应返回第一个值；后续调用按需推进内部状态
• 一旦返回 { done: true }，后续调用应始终返回相同结果（规范建议，非强制）

手写一个简单的数组风格迭代器

比如给一个类数组对象（如 { 0: 'a', 1: 'b', length: 2 }）添加迭代能力：

const arrayLike = {
  0: 'a',
  1: 'b',
  length: 2,
  [Symbol.iterator]() {
    let i = 0;
    return {
      next: () => {
        if (i for (const item of arrayLike) {
console.log(item); // 'a', 'b'
}

关键点：Symbol.iterator 是生成器函数的“入口”，它的返回值才是真正的迭代器对象；闭包保存了 i 状态，避免多次遍历时互相干扰。

用生成器函数 function* 简化自定义迭代逻辑

手写 next() 容易出错，而生成器函数天然满足迭代器协议——其返回值直接就是迭代器对象。

• 生成器函数内用 yield 暂停并产出值，执行流由 next() 控制
• 适合异步迭代、惰性求值、递归遍历树结构等复杂场景
• 不能直接在普通对象上定义 function* 方法（语法不允许），需包裹在 [Symbol.iterator] 中

示例：实现一个倒序迭代数字范围的可迭代对象

class ReverseRange {
  constructor(start, end) {
    this.start = start;
    this.end = end;
  }
  [Symbol.iterator]*() {
    for (let i = this.end; i >= this.start; i--) {
      yield i;
    }
  }
}
<p>for (const n of new ReverseRange(2, 4)) {
console.log(n); // 4, 3, 2
}
</p>

哪些地方会隐式触发 Symbol.iterator？

除了显式调用 obj[Symbol.iterator]().next()，以下操作都会尝试获取并使用迭代器：

• for...of 循环
• Array.from(obj)
• [...obj] 展开运算符
• new Set(obj)、new Map([[k,v], ...obj])
• yield* obj（在生成器中委托迭代）

如果对象没有实现 Symbol.iterator，这些操作会抛出 TypeError: obj is not iterable。调试时遇到这个错误，优先检查是否漏写了 [Symbol.iterator] 方法，而不是怀疑数据类型。

自定义迭代逻辑最常被忽略的是边界控制和状态重用问题：同一个可迭代对象可以被多次遍历，每次都要返回**全新**的迭代器实例，否则第二次 for...of 可能直接从上次结束位置继续，甚至返回 { done: true } 导致空循环。

今天关于《JavaScript迭代器使用教程：自定义可迭代对象》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！