CKTIS / JavaScript
Map.prototype.forEach: callback per ogni voce
Il metodo forEach chiama un callback per ogni voce Map nell’ordine di inserimento, passando valore, chiave e la Map stessa.
Versione: ECMAScript 2015 onward; example target: Node.js 24.22.2
Sintassi
map.forEach(callbackFn[, thisArg])map.forEach(callbackFn, thisArg?) invoca callbackFn(value, key, map) per ogni voce non eliminata e restituisce undefined. Gli argomenti iniziano dal valore, diversamente da entries(). thisArg facoltativo diventa this secondo le regole normali; una freccia lo ignora per this lessicale.
L’attraversamento è vivo, non un’istantanea. Una voce eliminata prima della visita è saltata; se eliminata e reinserita può essere visitata nella nuova posizione, così come una voce aggiunta prima della fine. Aggiornare una chiave non ancora visitata passa il nuovo valore.
Callback non invocabile o ricevitore errato genera TypeError; un’eccezione ferma il percorso. Non esiste break integrato e le Promise non sono attese. Standard da ECMAScript 2015; usare for...of per break, continue o await sequenziale.
Esempi
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);
}Risultato
#a:1,#c:3 true a:1,c:3 true