WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Map.prototype.forEach: Callback für jeden Eintrag

Die Methode forEach ruft für jeden Map-Eintrag in Einfügereihenfolge einen Callback mit Wert, Schlüssel und Map auf.

Version: ECMAScript 2015 onward; example target: Node.js 24.22.2

Syntax

map.forEach(callbackFn[, thisArg])

map.forEach(callbackFn, thisArg?) ruft callbackFn(value, key, map) für jeden nicht gelöschten Eintrag auf und liefert undefined. Die Argumente beginnen anders als bei entries() mit dem Wert. Optionales thisArg wird nach normalen Regeln zu this; eine Pfeilfunktion ignoriert es wegen lexikalischem this.

Der Durchlauf ist lebend, keine Momentaufnahme. Vor dem Besuch gelöschte Einträge werden übersprungen; gelöschte und erneut eingefügte können an neuer Position besucht werden, ebenso vor Abschluss hinzugefügte. Eine Änderung eines noch nicht besuchten Schlüssels liefert den neuen Wert.

Nicht aufrufbarer Callback oder falscher Empfänger löst TypeError aus; eine Callback-Ausnahme beendet den Durchlauf. Es gibt kein eingebautes break und Promises werden nicht erwartet. Seit ECMAScript 2015 Standard; für break, continue oder sequenzielles await dient for...of.

Beispiele

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);
}

Ergebnis

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

Quellen