Set.prototype[Symbol.iterator]()

Baseline 已广泛支持

此特性已相当成熟,可在许多设备和浏览器版本上使用。自 2015 年 9 月以来,该特性已在各大浏览器中可用。

[Symbol.iterator]() 方法是 Set 实例的一部分,它实现了 可迭代协议,并允许 Set 对象被大多数期望可迭代对象的语法使用,例如 扩展语法for...of 循环。它返回一个 set 迭代器对象,该对象按插入顺序生成 set 中的值。

此属性的初始值与 Set.prototype.values 属性的初始值是同一个函数对象。

试一试

const set = new Set();

set.add(42);
set.add("forty two");

const iterator = set[Symbol.iterator]();

console.log(iterator.next().value);
// Expected output: 42

console.log(iterator.next().value);
// Expected output: "forty two"

语法

js
set[Symbol.iterator]()

参数

无。

返回值

Set.prototype.values() 返回相同的值:一个新的 可迭代迭代器对象,它生成 set 中的值。

示例

使用 for...of 循环进行迭代

请注意,你很少需要直接调用此方法。[Symbol.iterator]() 方法的存在使得 Set 对象 可迭代,并且像 for...of 循环这样的迭代语法会自动调用此方法来获取迭代器以进行循环。

js
const mySet = new Set();
mySet.add("0");
mySet.add(1);
mySet.add({});

for (const v of mySet) {
  console.log(v);
}

手动创建迭代器

你仍然可以手动调用返回的迭代器对象的 next() 方法,以实现对迭代过程的最大控制。

js
const mySet = new Set();
mySet.add("0");
mySet.add(1);
mySet.add({});

const setIter = mySet[Symbol.iterator]();

console.log(setIter.next().value); // "0"
console.log(setIter.next().value); // 1
console.log(setIter.next().value); // {}

规范

规范
ECMAScript® 2026 语言规范
# sec-set.prototype-%symbol.iterator%

浏览器兼容性

另见