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% |
瀏覽器相容性
載入中…