Array.prototype[Symbol.iterator]()
[Symbol.iterator]() 方法是 Array 实例的一部分，它实现了 可迭代协议，并允许数组被大多数期望可迭代对象的语法使用，例如 展开语法 和 for...of 循环。它返回一个 数组迭代器对象，该对象会逐个生成数组中每个索引的值。
此属性的初始值与 Array.prototype.values 属性的初始值是同一个函数对象。
试一试
const array = ["a", "b", "c"];
const iterator = array[Symbol.iterator]();
for (const value of iterator) {
console.log(value);
}
// Expected output: "a"
// Expected output: "b"
// Expected output: "c"
语法
js
array[Symbol.iterator]()
参数
无。
返回值
返回值与 Array.prototype.values() 相同：一个新的 可迭代迭代器对象，该对象会逐个生成数组中每个索引的值。
示例
使用 for...of 循环进行迭代
请注意，你很少需要直接调用此方法。[Symbol.iterator]() 方法的存在使得数组成为 可迭代的，而诸如 for...of 循环之类的迭代语法会自动调用此方法来获取迭代器以进行循环。
HTML
html
<ul id="letterResult"></ul>
JavaScript
js
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);
}
结果
手动创建迭代器
你仍然可以手动调用返回的迭代器对象的 next() 方法，以实现对迭代过程的最大控制。
js
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() 更好，后者要求输入是一个数组，或者至少是一个具有该方法的对象。
js
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.
规范
| 规范 |
|---|
| ECMAScript® 2026 语言规范 # sec-array.prototype-%symbol.iterator% |
浏览器兼容性
加载中…