Iterator.prototype[Symbol.iterator]()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Iterator 实例的 [Symbol.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);
}
// 输出：1、2、3

规范

Specification
ECMAScript Language Specification
# sec-%iteratorprototype%-%symbol.iterator%

浏览器兼容性

BCD tables only load in the browser

参见