JavaScript迭代器协议要求对象有next()方法，返回{value, done}对象；next()可多次调用、不传参（生成器除外）、不幂等；状态须封装在实例内；可迭代对象需实现[Symbol.iterator]。
JavaScript 迭代器协议的核心是 next() 方法
迭代器协议本身不依赖某个类或接口，只规定：只要一个对象有 next() 方法，且该方法返回形如 { value: any, done: boolean } 的对象，它就符合迭代器协议。这个 next() 必须可被多次调用，每次返回下一个值，直到 done: true。
注意：next() 不接受参数（除非是生成器迭代器，可传入值给 yield 表达式），也不保证幂等——调用两次通常返回不同结果。
手动实现一个可复用的数组迭代器
不能直接让普通对象“变”成迭代器，必须显式构造一个带 next() 的对象。常见错误是把 index 放在外部作用域导致多个遍历互相干扰，正确做法是把状态封装在迭代器实例内。
-
value是当前项，done为true时value可省略（但最好仍返回undefined） - 迭代器本身不需要
[Symbol.iterator]()，只有“可迭代对象”才需要这个方法来返回一个迭代器 - 若想让自定义对象支持
for...of，必须实现[Symbol.iterator]并返回符合协议的迭代器
function createArrayIterator(arr) {
let index = 0;
return {
next() {
if (index < arr.length) {
return { value: arr[index++], done: false };
} else {
return { value: undefined, done: true };
}
}
};
}
const it = createArrayIterator(['a', 'b', 'c']);
console.log(it.next()); // { value: 'a', done: false }
console.log(it.next()); // { value: 'b', done: false }
console.log(it.next()); // { value: 'c', done: false }
console.log(it.next()); // { value: undefined, done: true }
[Symbol.iterator] 是让对象支持 for...of 的关键
仅实现 next() 不足以让对象被 for...of 消费；JS 引擎会先尝试调用对象的 [Symbol.iterator] 方法，再用其返回值进行遍历。这个方法必须返回一个迭代器（即含 next() 的对象）。
立即学习“Java免费学习笔记（深入）”；
容易忽略的一点：每次调用 [Symbol.iterator] 都应返回**新迭代器**，否则多个 for...of 同时遍历会共享状态、相互干扰。
const counter = {
from: 1,
to: 3,
[Symbol.iterator]() {
let current = this.from;
const last = this.to;
return {
next() {
if (current <= last) {
return { value: current++, done: false };
} else {
return { value: undefined, done: true };
}
}
};
}
};
for (const n of counter) {
console.log(n); // 1, 2, 3
}
自定义迭代器的边界与陷阱
迭代器协议非常轻量，但也因此缺乏内置约束。实际使用中几个高频问题：
- 忘记在
done: true后继续返回{ value: undefined, done: true }——后续调用行为未定义，部分环境可能报错或死循环 - 误把迭代器本身当作可迭代对象（比如对迭代器再套一层
for...of），会触发TypeError: xxx is not iterable - 异步迭代器需用
[Symbol.asyncIterator]和next()返回Promise，和同步协议完全分离，不能混用 - 性能上，手写迭代器比原生数组
values()或entries()更重，除非有特殊逻辑（如跳过、变换、限流），否则优先用内置
真正需要手写迭代器的场景其实不多：惰性计算序列、包装底层数据源（如 WebSocket 流）、或实现特定遍历策略（如树的深度优先/广度优先）。多数时候，用 Array.prototype.values() 或生成器函数更安全简洁。
