Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

Map.prototype.forEach: callback para cada entrada

El método forEach llama a un callback por cada entrada de Map en orden de inserción, pasando valor, clave y el propio Map.

Versión: ECMAScript 2015 onward; example target: Node.js 24.22.2

Sintaxis

map.forEach(callbackFn[, thisArg])

map.forEach(callbackFn, thisArg?) llama a callbackFn(value, key, map) por cada entrada no eliminada y devuelve undefined. Los argumentos empiezan por el valor, a diferencia de entries(). thisArg opcional se convierte en this según reglas ordinarias; una flecha lo ignora por su this léxico.

El recorrido es vivo, no una instantánea. Una entrada eliminada antes de visitarla se omite; eliminada y añadida de nuevo puede visitarse en su posición nueva, y una añadida antes del final también. Cambiar una clave aún no visitada entrega el valor nuevo.

Un callback no invocable o receptor incorrecto lanza TypeError; una excepción detiene el recorrido. No hay break integrado y no se esperan promesas. Es estándar desde ECMAScript 2015; use for...of para break, continue o await secuencial.

Ejemplos

const map = new Map([["a", 1], ["b", 2]]);
const seen = [];
const result = map.forEach(function (value, key, original) {
  seen.push(this.prefix + key + ":" + value);
  if (key === "a") {
    original.delete("b");
    original.set("c", 3);
  }
}, { prefix: "#" });

console.log(seen.join(","));
console.log(result === undefined);
console.log([...map].map(([key, value]) => key + ":" + value).join(","));

try {
  map.forEach(null);
} catch (error) {
  console.log(error instanceof TypeError);
}

Resultado

#a:1,#c:3
true
a:1,c:3
true

Fuentes