掌握JS迭代器与可迭代协议，轻松自定义迭代器

JavaScript的迭代器与可迭代协议是语言层面统一的遍历契约，核心在于对象必须实现无参的[Symbol.iterator]方法并返回符合next()规范（含value和done属性）的全新迭代器对象，从而让for...of、扩展运算符、Array.from等语法无缝消费——它不依赖具体数据结构，只认协议；原生类型已内置支持，而手动实现需谨慎管理状态，生成器函数则能优雅简化逻辑；真正考验功力的不是“能跑”，而是写出健壮、可重入、语义清晰且严格遵循协议细节（如done: true后持续返回、不可复用迭代器、正确处理边界）的自定义迭代器，这直接决定了它能否安全融入复杂数据流与第三方生态。

JavaScript 的迭代器和可迭代协议不是语法糖，而是语言级的遍历契约：只要对象实现了 [Symbol.iterator] 方法并返回符合 next() 协议的对象，它就能被 for...of、[...iterable]、Array.from()、解构赋值等所有消费可迭代对象的语法无缝使用。

为什么对象加了 [Symbol.iterator] 就能用 for...of？

因为 for...of 会自动调用该方法获取迭代器，再反复调用其 next()，直到 done: true。这个过程不依赖数组索引、也不关心内部结构——只认协议。

• [Symbol.iterator] 必须是无参函数，每次调用都应返回**全新迭代器对象**（否则多次遍历会互相干扰）
• next() 返回的对象必须有 value 和 done 两个属性；done: true 后，value 可省略或为 undefined（但不能缺失 done）
• 原生类型如 Array、String、Map、Set 都已内置实现，所以天然支持

手动实现迭代器：状态管理容易出错，但适合学习原理

手写 next() 要自己维护当前状态（比如计数器、游标），稍不注意就会漏掉边界判断或重复返回。

class Range {
  constructor(from, to) {
    this.from = from;
    this.to = to;
  }
  [Symbol.iterator]() {
    let current = this.from;
    return {
      next() {
        if (current 

• 错误常见于：忘记在循环末尾返回 { done: true }，导致 for...of 死循环
• 不要在 [Symbol.iterator] 外部闭包中复用同一个 current 变量，否则多个 for...of 同时遍历会冲突
• 如果需要支持异步迭代（如读取文件流），手写更复杂，此时应优先考虑 AsyncIterator

用生成器函数 function* 实现：简洁、安全、推荐日常使用

生成器函数天然返回符合迭代器协议的对象，yield 自动暂停/恢复执行，状态由引擎托管，几乎不会出错。

class Countdown {
  constructor(from) {
    this.from = from;
  }
  *[Symbol.iterator]() {
    for (let i = this.from; i > 0; i--) {
      yield i; // 每次 yield 对应一次 next() 调用
    }
  }
}
console.log([...new Countdown(3)]); // [3, 2, 1]

• yield 后面的值就是 next().value；函数结束自动返回 { done: true }
• 生成器函数内部可自由使用 if、while、甚至 await（配合 async function*）
• 注意：生成器函数不能用箭头函数替代（()* => {} 语法非法）

自定义迭代器最容易被忽略的坑

不是“怎么写”，而是“怎么用对”：很多问题其实出在协议理解偏差上。

• done: true 后继续调用 next()，仍应返回 { done: true }（不能抛错，也不能重置）
• 对象本身不可迭代 ≠ 没有 [Symbol.iterator]，可能是你查错了原型链（比如直接在实例上定义，但忘了绑定 this）
• 解构赋值和扩展运算符（[...obj]）同样依赖该协议，但它们会**立即消耗整个迭代器**，不适合无限序列（如 function* infinite() { while(true) yield Date.now(); }）
• 若需支持多次遍历（如一个 Range 被展开两次），[Symbol.iterator] 必须每次都返回新迭代器，不能缓存或复用

真正难的不是写出一个能跑的迭代器，而是写出一个**健壮、可重入、语义清晰**的迭代器——尤其当它要暴露给他人使用，或嵌入到数据处理管道中时，协议细节决定它能不能被放心地交给 Array.from 或第三方库处理。

到这里，我们也就讲完了《掌握JS迭代器与可迭代协议，轻松自定义迭代器》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！