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%

浏览器兼容性

另见