Symbol.iterator 是让对象支持 for...of 等迭代语法的核心机制,需显式定义为返回符合迭代器协议对象的可枚举方法,内置类型已实现,普通对象默认不支持。

Symbol.iterator 是 JavaScript 中让对象支持 for...of、展开运算符([...obj])、解构赋值等迭代语法的核心机制。它不是一个“自动可用”的功能,而是需要开发者显式定义一个返回迭代器对象的方法。
Symbol.iterator 的本质是一个方法,不是属性
它必须是对象的一个**可枚举的、键为 Symbol.iterator 的函数**,该函数被调用后需返回一个符合迭代器协议(iterator protocol)的对象。这个返回对象必须有 next() 方法,且 next() 返回形如 { value, done } 的对象。
- 如果对象没有
[Symbol.iterator]方法,for...of会直接报错:TypeError: xxx is not iterable - 该方法可以是普通函数、箭头函数或生成器函数(
function*),但箭头函数无法用this访问原对象,需谨慎 - 内置类型(如 Array、Map、Set、String)已预置该方法;Object 默认没有,所以普通对象不能直接
for...of
手动实现一个基础迭代器
以类数组对象为例,模拟数组的迭代行为:
const myArrayLike = {
0: 'a',
1: 'b',
2: 'c',
length: 3,
[Symbol.iterator]() {
let i = 0;
return {
next: () => {
if (i < this.length) {
return { value: this[i++], done: false };
}
return { value: undefined, done: true };
}
};
}
};
[...myArrayLike]; // ['a', 'b', 'c']
注意:迭代器内部通常需维护状态(如当前索引 i),且 next() 必须是闭包或绑定上下文,否则 this 会丢失。
立即学习“Java免费学习笔记(深入)”;
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
用生成器函数简化实现
生成器函数天然满足迭代器协议,写法更简洁、状态管理更安全:
const counter = {
from: 1,
to: 3,
*[Symbol.iterator]() {
for (let i = this.from; i <= this.to; i++) {
yield i;
}
}
};
[...counter]; // [1, 2, 3]
- 生成器函数自动返回一个迭代器对象,无需手动实现
next -
yield表达式的值成为value,函数退出或完成时done自动为true - 生成器内部可使用
this(前提是不使用箭头函数定义生成器)
迭代器的“单次消耗”特性
迭代器对象是**一次性**的:一旦遍历结束(done: true),后续调用 next() 永远返回 { value: undefined, done: true }。多次 for...of 同一个对象,每次都会重新调用 [Symbol.iterator]() 方法,因此应确保该方法每次都返回**新迭代器**。
错误示例(共享状态,不可重用):
let iter = null;
obj[Symbol.iterator] = () => {
if (!iter) iter = createIterator();
return iter; // ❌ 错误:所有遍历共用一个迭代器
};
正确做法是每次调用都新建迭代器实例(生成器函数天然满足这点)。

















