forEach 方法 (Map)

对映射中的每个元素实施指定的操作。

语法

mapObj.forEach(callbackfn[, thisArg])

参数

mapObj

必要参数。Map对象。

callbackfn

必要参数。对于映射中的每个元素，forEach都会调用函数一次。callbackfn最多接受三个参数。对于映射中的每个元素，forEach都会调用callbackfn函数一次。

thisArg

可选参数。可在callbacnfn函数中为其引用this关键字的对象。如果省略了thisArg，则undefined将用作this值。

异常

如果callbackfn参数不是函数对象，则将抛出TypeError异常。

备注

回调函数的语法如下所示：

function callbackfn(value, key, mapObj)

你可以使用最多三个参数声明回调函数，如下表所示。

示例

下面的示例演示了如何通过使用forEach检索Map的成员。

var m = new Map();
m.set(1, "black");
m.set(2, "red");
m.set("colors", 2);
m.set({x:1}, 3);
m.forEach(function (item, key, mapObj) {
  document.write(item.toString() + "<br />");
});
document.write("<br />");
document.write(m.get(2));
// Output:
// black
// red
// 2
// 3
//
// red

必备条件

在Internet Explorer 11标准文档模式下支持此项。此外，也在应用商店应用（Windows 8.1和Windows Phone 8.1）中受支持。请参阅版本信息。

在以下文档模式中不受支持：怪异模式、Internet Explorer 6标准模式、Internet Explorer 7标准模式、Internet Explorer 8标准模式、Internet Explorer 9标准模式和Internet Explorer 10标准模式。在Windows 8中不受支持。