Iterator.prototype[Symbol.iterator]()

Baseline 已廣泛支援

此特性已非常成熟,可在多種裝置和瀏覽器版本上使用。自 ⁨2016 年 9 月⁩以來,它已在各大瀏覽器中可用。

[Symbol.iterator]() 方法是 Iterator 例項的成員,它實現了 可迭代協議,並允許內建迭代器被大多數期望可迭代物件的語法(如 展開語法for...of 迴圈)所使用。它返回 this 的值,即迭代器物件本身。

語法

js
iterator[Symbol.iterator]()

引數

無。

返回值

this 的值,即迭代器物件本身。

示例

使用 for...of 迴圈進行迭代

請注意,你很少需要直接呼叫此方法。[Symbol.iterator]() 方法的存在使得內建迭代器 可迭代,而像 for...of 迴圈這樣的迭代語法會自動呼叫此方法來獲取要遍歷的迭代器。

js
const arrIterator = [1, 2, 3].values();
for (const value of arrIterator) {
  console.log(value);
}
// Logs: 1, 2, 3

規範

規範
ECMAScript® 2026 語言規範
# sec-%iteratorprototype%-%symbol.iterator%

瀏覽器相容性

另見