Map.prototype.forEach()

Prubalo

function logMapElements(value, key, map) {
  console.log(`m[${key}] = ${value}`);
}

new Map([
  ["foo", 3],
  ["bar", {}],
  ["baz", undefined],
]).forEach(logMapElements);

// Expected output: "m[foo] = 3"
// Expected output: "m[bar] = [object Object]"
// Expected output: "m[baz] = undefined"

Sintaxis

forEach(callbackFn)
forEach(callbackFn, thisArg)

Parmetro

callbackFn

Una funcin que se ejecuta por cada entrada en el map. La funcin es llamada con los siguientes argumentos:

value

El valor de cada iteracin.

key

La llave de cada iteracin.

map

El map que esta siendo iterado.

thisArg Opcional

Un valor que se usa como this cuando se ejecuta la funcin callbackFn.

Valor devuelto

Ningno (undefined).

Descripcin

El mtodo forEach ejecuta la funcin callback provista, una vez por cada llave que actualmente existe en el map. No se invoca para llaves que fueron borradas. Sin embargo, la funcin es ejecutada para valores que se encuentran en el objeto, pero que su valor es undefined.

La funcin callback es invocada con tres argumentos:

• el value del elemento
• el key del elemento
• el objeto Map que se esta iterando

Si el parmetro thisArg se provee a la funcin forEach, este se pasar a la funcin callback cuando sea invocada, para usarse como el valor this. De lo contrario, el valor undefined ser pasado para usarse como el valor this. El valor this que finalmente es visible para la funcin callback, es determinado de acuerdo a las reglas para determinar el valor this visible para una funcin.

Cada valor es visitado una vez, excepto en el caso en que el valor es borrado y agregado antes de que forEach haya terminado. La funcin callback no es invocada para valores que se borraron antes de ser visitados. Los valores agregados antes de que forEach termine, sern visitados.

Ejemplos

Imprimiendo el contenido de un objeto Map

El siguiente cdigo, registra en la consola un mensaje por cada elemento en un objeto Map:

function logMapElements(value, key, map) {
  console.log(`map.get('${key}') = ${value}`);
}
new Map([
  ["foo", 3],
  ["bar", {}],
  ["baz", undefined],
]).forEach(logMapElements);
// Logs:
// "map.get('foo') = 3"
// "map.get('bar') = [object Object]"
// "map.get('baz') = undefined"

Especificaciones

Compatibilidad con navegadores

Vase tambin

• Array.prototype.forEach()
• Set.prototype.forEach()