大网数据广告活动
Web 标准与前端开发

Array.prototype[Symbol.iterator]()

· 52CE 我爱测

Array 实例的 **`Symbol.iterator`** 方法实现了可迭代协议,允许数组被大多数期望可迭代对象的语法所使用,例如展开语法和 Statements/for...of 循环。它返回一个数组迭代器对象,该对象会产生数组中每个索引的值。

Array 实例的 [Symbol.iterator]() 方法实现了可迭代协议,允许数组被大多数期望可迭代对象的语法所使用,例如展开语法和 Statements/for...of 循环。它返回一个数组迭代器对象,该对象会产生数组中每个索引的值。

该属性的初始值与 Array.prototype.values 属性的初始值是相同的函数对象。

JavaScript Demo: Array.prototypeSymbol.iterator

const array1 = ["a", "b", "c"];
const iterator1 = array1[Symbol.iterator]();

for (const value of iterator1) {
  console.log(value);
}

// Expected output: "a"
// Expected output: "b"
// Expected output: "c"

语法

array[Symbol.iterator]()

返回值

与 Array.prototype.values() 相同的返回值:一个新的可迭代迭代器对象,它会生成数组中每个索引的值。

示例

使用 for...of 循环进行迭代

请注意,你很少需要直接调用此方法。[Symbol.iterator]() 方法的存在使数组可迭代,并且像 for...of 循环这样的迭代语法会自动调用此方法以获得要遍历的迭代器。

HTML

<ul id="letterResult"></ul>

JavaScript

const arr = ["a", "b", "c"];
const letterResult = document.getElementById("letterResult");
for (const letter of arr) {
  const li = document.createElement("li");
  li.textContent = letter;
  letterResult.appendChild(li);
}

结果

使用 for...of 循环进行迭代

手动执行迭代器

你仍然可以手动调用返回迭代器对象的 next() 方法,以实现对迭代过程的最大控制。

const arr = ["a", "b", "c", "d", "e"];
const arrIter = arr[Symbol.iterator]();
console.log(arrIter.next().value); // a
console.log(arrIter.next().value); // b
console.log(arrIter.next().value); // c
console.log(arrIter.next().value); // d
console.log(arrIter.next().value); // e

使用相同的函数处理字符串和字符串数组

因为字符串和数组都实现了可迭代协议,所以可以设计一个通用函数以相同的方式处理这两种输入。这比直接调用 Array.prototype.values() 更好,后者要求输入是一个数组,或者至少是一个具有这种方法的对象。

function logIterable(it) {
  if (typeof it[Symbol.iterator] !== "function") {
    console.log(it, "不可迭代。");
    return;
  }
  for (const letter of it) {
    console.log(letter);
  }
}

// 数组
logIterable(["a", "b", "c"]);
// a
// b
// c

// 字符串
logIterable("abc");
// a
// b
// c

// 数值
logIterable(123);
// 123 不可迭代。

规范

浏览器兼容性

参见

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。