JavaScript迭代器是支持for...of等语法的协议机制，核心为返回{value,done}对象的next()方法；需同时满足可迭代协议（含[Symbol.iterator]方法）和迭代器协议（next方法返回指定结构对象）。

JavaScript迭代器是一种让对象支持for...of循环和解构等语法的协议机制，核心在于提供一个返回{ value, done }对象的next()方法。它不等于数组或类数组，而是一套可被统一消费的遍历接口。

迭代器协议：两个关键角色

要让一个对象可迭代，需满足两个协议：

• 可迭代协议（Iterable Protocol）：对象必须有[Symbol.iterator]方法，该方法返回一个迭代器对象；
• 迭代器协议（Iterator Protocol）：返回的对象必须有next()方法，每次调用返回形如{ value: any, done: boolean }的对象。

手写一个简单迭代器

比如实现一个从 start 到 end 的数字范围迭代器：

function range(start, end) {
  return {
    [Symbol.iterator]() {
      let current = start;
      return {
        next() {
          if (current <= end) {
            return { value: current++, done: false };
          } else {
            return { value: undefined, done: true };
          }
        }
      };
    }
  };
}
<p>// 使用
for (const num of range(2, 5)) {
console.log(num); // 2, 3, 4, 5
}

用生成器函数简化迭代器实现

生成器函数（function*）天然符合迭代器协议，yield会自动封装为{value, done}，大幅降低手写成本：

java-api-doc-generator

分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。

下载

立即学习“Java免费学习笔记（深入）”；

function* rangeGen(start, end) {
  for (let i = start; i <= end; i++) {
    yield i;
  }
}
<p>const it = rangeGen(2, 4);
console.log(it.next()); // { value: 2, done: false }
console.log([...rangeGen(2, 4)]); // [2, 3, 4]

几乎所有内置集合（Array、Map、Set、String）都实现了[Symbol.iterator]，所以能直接用于for...of或扩展运算符。

自定义遍历的关键点

想让自己的类或对象支持自定义遍历，只需在原型或实例上部署[Symbol.iterator]方法：

• 返回一个对象，该对象的next()控制每次产出什么；
• done: true表示遍历结束，之后的next()调用仍应返回{ value: undefined, done: true }；
• value可以是任意类型，包括undefined（只要done为false）；
• 迭代器可以是惰性的（如生成器）、状态化的（如维护内部指针），也可设计成只读或单次使用。

不复杂但容易忽略