Array.prototype[Symbol.iterator]()

基线 广泛可用

此功能已建立良好，可在许多设备和浏览器版本上运行。自 2018 年 5 月.

报告反馈

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

试一试

语法

此属性的初始值与 Array.prototype.values 属性的初始值相同。
array[Symbol.iterator]()

js

参数

无。

返回值

示例

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

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

HTML

请注意，你很少需要直接调用此方法。[Symbol.iterator]() 方法的存在使数组成为 可迭代的，像 for...of 循环这样的迭代语法会自动调用此方法来获取要循环的迭代器。
<ul id="letterResult"></ul>

JavaScript

此属性的初始值与 Array.prototype.values 属性的初始值相同。
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);
}

html

结果

手动滚动迭代器

此属性的初始值与 Array.prototype.values 属性的初始值相同。
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

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

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

此属性的初始值与 Array.prototype.values 属性的初始值相同。
function logIterable(it) {
  if (typeof it[Symbol.iterator] !== "function") {
    console.log(it, "is not iterable.");
    return;
  }
  for (const letter of it) {
    console.log(letter);
  }
}

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

// String
logIterable("abc");
// a
// b
// c

// Number
logIterable(123);
// 123 is not iterable.

规范

由于 字符串 和数组都实现了可迭代协议，因此可以设计一个通用的函数来以相同的方式处理这两种输入。这比直接调用 Array.prototype.values() 更好，后者需要输入是一个数组，或者至少是一个具有此方法的对象。
规范
# ECMAScript 语言规范

浏览器兼容性

sec-array.prototype-%symbol.iterator%

另请参阅