JavaScript迭代器是遵循特定协议的对象:拥有[Symbol.iterator]方法且返回含next()的对象;next()必须返回{value, done}结构,done为true后须恒返{value: undefined, done: true}。

什么是 JavaScript 迭代器(Iterator)?
迭代器不是语法糖,而是一个明确的协议(protocol):只要一个对象有 [Symbol.iterator] 方法,且该方法返回一个符合迭代器接口的对象(即有 next() 方法),它就是可迭代的。数组、字符串、Map、Set 都原生实现了这个协议;普通对象默认不实现,所以不能直接用 for...of 遍历。
关键点在于:next() 必须返回形如 { value: any, done: boolean } 的对象。一旦 done 为 true,后续调用都应返回 { value: undefined, done: true } —— 这是规范强制要求,不是可选行为。
如何手动创建一个迭代器?
手动实现能帮你真正看清迭代器的控制流和状态管理。比如实现一个从 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 };
}
}
};
}
};
}
for (const n of range(1, 3)) {
console.log(n); // 1, 2, 3
}
注意几个实操细节:
立即学习“Java免费学习笔记(深入)”;
-
[Symbol.iterator]是一个方法,不是属性;每次调用它都应返回一个**新**的迭代器实例(否则多次遍历会互相干扰) -
next()内部不能依赖闭包外的可变状态(如全局变量),必须把迭代进度封装在迭代器对象内部 - 如果忘了返回
{ value: undefined, done: true },某些消费方(如扩展运算符[...it])可能无限循环或抛错
for...of、扩展运算符和 Array.from 的区别在哪?
三者都依赖 [Symbol.iterator],但行为边界不同:
-
for...of是语言级语法,只接受可迭代对象,遇到非迭代器会报TypeError: X is not iterable - 扩展运算符
[...it]同样严格,但它会**立即消耗整个迭代器**;若迭代器是“一次性”的(如GeneratorFunction返回值),二次展开会得到空数组 -
Array.from(it)更宽容:它会先检查it[Symbol.iterator],没找到则尝试用it.length和数字索引模拟类数组行为(比如对纯对象无效,但对有length和索引属性的类数组有效)
常见错误场景:把一个只实现了 next() 但没挂载 [Symbol.iterator] 的对象直接传给 for...of,会报错——它不是“迭代器”,而是“迭代器返回值”,缺少协议入口。
Generator 函数为什么是迭代器的快捷写法?
function* 声明的函数,调用后直接返回一个符合迭代器协议的对象,yield 自动处理 value 和暂停逻辑。它省去了手写 next() 状态机的麻烦,但本质仍是迭代器。
function* fibonacci() {
let [a, b] = [0, 1];
while (true) {
yield a;
[a, b] = [b, a + b];
}
}
const fib = fibonacci();
console.log(fib.next()); // { value: 0, done: false }
console.log(fib.next()); // { value: 1, done: false }
console.log(fib.next()); // { value: 1, done: false }
要注意的是:Generator 函数返回的迭代器**不可重用**。一旦 done: true,再次调用 next() 永远返回 { value: undefined, done: true };想重新开始,必须重新调用 fibonacci() 创建新实例。
真正容易被忽略的点是:迭代器协议本身不规定“是否可多次遍历”。数组可以,Generator 不行,自定义迭代器取决于你是否在 [Symbol.iterator] 中每次都返回新状态。这点直接影响你在 map、filter 或 React 渲染中能否安全复用同一个迭代器变量。











