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]并返回符合协议的迭代器
[Symbol.iterator]
- 忘记在
done: true后继续返回{ value: undefined, done: true }——后续调用行为未定义,部分环境可能报错或死循环 - 误把迭代器本身当作可迭代对象(比如对迭代器再套一层
for...of),会触发TypeError: xxx is not iterable - 异步迭代器需用
[Symbol.asyncIterator]和next()返回Promise,和同步协议完全分离,不能混用 - 性能上,手写迭代器比原生数组
values()或entries()更重,除非有特殊逻辑(如跳过、变换、限流),否则优先用内置
真正需要手写迭代器的场景其实不多:惰性计算序列、包装底层数据源(如 WebSocket 流)、或实现特定遍历策略(如树的深度优先/广度优先)。多数时候,用 Array.prototype.values() 或生成器函数更安全简洁。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











