Set.prototype.forEach() - JavaScript 编辑

forEach 方法会根据集合中元素的插入顺序，依次执行提供的回调函数。

语法

mySet.forEach(callback[, thisArg])

参数

callback

为集合中每个元素执行的回调函数，该函数接收三个参数：

currentValue, currentKey可选

currentValue 是正在被操作的元素。并且由于集合没有索引，所以 currentKey 也表示这个正在被操作的元素。

set可选

调用当前 forEach 方法的集合对象

thisArg可选

回调函数执行过程中的 this 值。

返回值

undefined.

描述

forEach 方法会依次为集合中的元素执行回调函数，就算元素的值是 undefined。

回调函数有三个参数:

• 元素的值
• 元素的索引
• 正在遍历的集合对象

但是由于集合对象中没有索引(keys)，所以前两个参数都是Set中元素的值(values)，之所以这样设计回调函数是为了和Map 以及Array的 forEach 函数用法保持一致。

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

forEach 函数为集合对象中每个元素都执行一次回调；它不会返回任何值。

例子

输出集合对象的内容

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

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

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

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

规范

Specification	Status	Comment
ECMAScript 2015 (6th Edition, ECMA-262) Set.prototype.forEach	Standard	Initial definition.

浏览器兼容性

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!

• Desktop
• Mobile

Feature	Chrome	Firefox (Gecko)	Internet Explorer	Opera	Safari
Basic support	38	25.0 (25.0)	11	25	7.1

Feature	Android	Chrome for Android	Firefox Mobile (Gecko)	IE Mobile	Opera Mobile	Safari Mobile
Basic support	未实现	38	25.0 (25.0)	未实现	未实现	8

参见

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