大网数据广告活动
Web 标准与前端开发

Set.prototype.forEach()

· 52CE 我爱测

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

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

JavaScript Demo: Set.prototype.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"

语法

forEach(callbackFn)
forEach(callbackFn, thisArg)

参数

  • callback
    • : 为集合中每个元素执行的函数,使用以下参数调用该函数:
      • value
        • : 每次迭代的值。
      • key
        • : 每次迭代的键。始终与 value 相同。
      • set
        • : 正在迭代的集合。
  • thisArg
    • : 执行 callbackFn 时用作 this 的值。

返回值

无(undefined)。

描述

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

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

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

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

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

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

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

示例

输出集合对象的内容

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

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"

规范

浏览器兼容性

参见

  • Array.prototype.forEach()
  • Map.prototype.forEach()

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。