Map.prototype.forEach()

forEach()方法将会以插入顺序对 Map 对象中的每一个键值对执行一次参数中提供的回调函数。

语法

myMap.forEach(callback[, thisArg])

参数

callback

必要，每个元素所要执行的函数。

thisArg

可选，callback执行时其this的值。

返回值

undefined.

概述

forEach方法将对Map中真实存在的每一个元素执行一次参数中提供的回调函数，它不会对任何已经被删除的元素执行调用。然而，它还会对键存在而值为undefined的元素执行调用。

callback函数有三个参数:

• value- 元素的值
• key- 元素的键
• Map- 当前正在被遍历的对象

如果参数forEach带有一个thisArg参数，在调用的时候，这个参数将传给callback函数作为其 this 的值。否则，函数将默认使用undefined传给callback函数作为其this值。最终，这里的this 的值将依照函数观测并确定this的相关规则由callback函数最终观察到的值决定。

forEach函数处理的元素的范围为第一次执行 callback 函数时 Map 对象中的键值对集合。在Map对象调用forEach之后加入的元素将不会被调用callback函数。如果在调用forEach之后Map对象中的被改变或者删除了，它们传给callback函数的值将会变成forEach函数访问它们时的值；callback不会访问其调用其间被删除的元素。

forEach 仅仅是对Map对象中的每一个元素执行一遍callback函数，然后直接返回undefined。

示例

打印一个Map 对象中的元素

下面的代码在一行中打印一个Map对象的每一个元素:

function logMapElements(value, key, map) {
    console.log("m[" + key + "] = " + value);
}
Map([["foo", 3], ["bar", {}], ["baz", undefined]]).forEach(logMapElements);
// logs:
// "m[foo] = 3"
// "m[bar] = [object Object]"
// "m[baz] = undefined"