CKTIS / JavaScript
Map.prototype.forEach: callback pro každou položku
Metoda forEach zavolá callback pro každou položku Map v pořadí vložení a předá hodnotu, klíč i samotnou Map.
Verze: ECMAScript 2015 onward; example target: Node.js 24.22.2
Syntaxe
map.forEach(callbackFn[, thisArg])map.forEach(callbackFn, thisArg?) volá callbackFn(value, key, map) pro každou neodstraněnou položku a vrátí undefined. Argumenty začínají hodnotou, na rozdíl od entries(). Volitelný thisArg se stane this; arrow funkce jej kvůli lexikálnímu this ignoruje.
Průchod je živý, nikoli snímek. Před návštěvou odstraněná položka se přeskočí; odstraněná a znovu přidaná může být navštívena na nové pozici, stejně jako položka přidaná před koncem. Změna dosud nenavštíveného klíče předá novou hodnotu.
Nevolatelný callback nebo chybný příjemce vyvolá TypeError; výjimka průchod zastaví. Není vestavěný break a Promise se nečekají. Standardní od ECMAScript 2015; pro break, continue či sekvenční await použijte for...of.
Příklady
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);
}Výsledek
#a:1,#c:3 true a:1,c:3 true