JavaScript迭代器核心是Symbol.iterator方法，需返回含next()的协议对象；next()须无参、首次返首值、done为true后恒定返回；自定义时须每次返回新迭代器实例。
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 < this.length) {
return { value: this[i++], done: false };
}
return { done: true };
}
};
}
};
for (const item of arrayLike) {
console.log(item); // 'a', 'b'
}
关键点：Symbol.iterator 是生成器函数的“入口”，它的返回值才是真正的迭代器对象；闭包保存了 i 状态，避免多次遍历时互相干扰。
立即学习“Java免费学习笔记（深入）”；
用生成器函数 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;
}
}
}
for (const n of new ReverseRange(2, 4)) {
console.log(n); // 4, 3, 2
}
哪些地方会隐式触发 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 } 导致空循环。
