Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

Map.prototype.forEach: callback para cada entrada

O método forEach chama um callback para cada entrada de Map pela ordem de inserção, passando o valor, a chave e o próprio Map.

Versão: ECMAScript 2015 onward; example target: Node.js 24.22.2

Sintaxe

map.forEach(callbackFn[, thisArg])

map.forEach(callbackFn, thisArg?) chama callbackFn(value, key, map) para cada entrada não eliminada e devolve undefined. Os argumentos começam pelo valor, ao contrário de entries(). thisArg opcional torna-se this pelas regras normais; uma arrow function ignora-o por this lexical.

A travessia é viva, não uma captura. Entrada eliminada antes da visita é ignorada; eliminada e readicionada pode ser visitada na nova posição, tal como uma adicionada antes do fim. Atualizar uma chave ainda não visitada passa o valor novo.

Callback não invocável ou recetor errado lança TypeError; uma exceção interrompe a travessia. Não há break integrado e Promises não são aguardadas. Padrão desde ECMAScript 2015; use for...of para break, continue ou await sequencial.

Exemplos

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

Fontes