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
<p>注意:迭代器内部通常需维护状态(如当前索引 <code>i</code>),且 <code>next()</code> 必须是闭包或绑定上下文,否则 <code>this</code> 会丢失。</p><div class="aritcle_card flexRow artxards">
<div class="artcardd flexRow">
<a class="aritcle_card_img" rel="nofollow" href="/xiazai/skill3430" title="Alibabacloud Sdk Client Initialization For Java"><img
src="https://img.php.cn/upload/skill/000/000/081/178955835420587.jpg" alt="Alibabacloud Sdk Client Initialization For Java" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
<div class="aritcle_card_info flexColumn">
<a rel="nofollow" href="/xiazai/skill3430" title="Alibabacloud Sdk Client Initialization For Java" class="overflowclass">Alibabacloud Sdk Client Initialization For Java</a>
<p class="overflowclass">在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。</p>
</div>
<a rel="nofollow" href="/xiazai/skill3430" title="Alibabacloud Sdk Client Initialization For Java" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span>
</a>
</div>
</div>
<h3>用生成器函数简化实现</h3>
<p>生成器函数天然满足迭代器协议,写法更简洁、状态管理更安全:</p>
<pre class="brush:php;toolbar:false;">const counter = {
from: 1,
to: 3,
*[Symbol.iterator]() {
for (let i = this.from; i
- 生成器函数自动返回一个迭代器对象,无需手动实现
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; // ❌ 错误:所有遍历共用一个迭代器
};
正确做法是每次调用都新建迭代器实例(生成器函数天然满足这点)。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










