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