Set.prototype.forEach()

基线广泛可用

自 2015年7月起，此特性已在主流浏览器中得到支持，可在大多数设备和浏览器版本中正常使用。

Set 实例的 forEach() 方法按插入顺序为该集合中的每个值执行一次提供的函数。

本文内容

尝试一下

function logSetElements(value1, value2, set) {
  console.log(`s[${value1}] = ${value2}`);
}

new Set(["foo", "bar", undefined]).forEach(logSetElements);

// Expected output: "s[foo] = foo"
// Expected output: "s[bar] = bar"
// Expected output: "s[undefined] = undefined"

语法

js
forEach(callbackFn)
forEach(callbackFn, thisArg)

参数

callback

为集合中每个元素执行的函数，使用以下参数调用该函数：

value

每次迭代的值。

key

每次迭代的键。始终与 value 相同。

set

正在迭代的集合。

thisArg 可选

执行 callbackFn 时用作 this 的值。

返回值

无（undefined）。

描述

forEach() 方法对 Set 对象中实际存在的每个值执行一次提供的 callback。对于已删除的值，不会调用它。但是，它会对存在但值为 undefined 的值执行。

callback 被调用时带有三个参数：

元素的值
元素的键
被遍历的 Set

Set 对象中没有键，所以前两个参数都是 Set 中包含的值。这是为了与 Map 和 Array 的 forEach() 方法保持一致。

如果提供了一个 thisArg 参数给 forEach 函数，则参数将会作为回调函数中的 this值。否则 this 值为 undefined。回调函数中 this 的绑定是根据函数被调用时通用的 this 绑定规则来决定的。

每个值都访问一次，除非在 forEach() 完成之前删除并重新添加它。在访问之前删除的值不会调用 callback。在 forEach() 完成之前添加的新值将被访问。

forEach() 对 Set 对象中的每个元素执行一次 callback 函数；它没有返回值。

示例

输出集合对象的内容

以下代码依次打印 Set 对象的元素：

js
function logSetElements(value1, value2, set) {
  console.log(`s[${value}] = ${value2}`);
}

new Set(["foo", "bar", undefined]).forEach(logSetElements);

// logs:
// "s[foo] = foo"
// "s[bar] = bar"
// "s[undefined] = undefined"

规范

ECMAScript® 2027 Language Specification
# sec-set.prototype.foreach

浏览器兼容性

启用 JavaScript 以查看此浏览器兼容性表。

参见

帮助改进 MDN

此页面对您有帮助吗？

是否

了解如何参与贡献

此页面最后更新于 2025年10月23日，由 MDN 贡献者更新。

在 GitHub 上查看此页面 • 报告此内容的问题