CKTIS / JavaScript
Map.prototype.forEach : callback pour chaque entrée
La méthode forEach appelle un callback pour chaque entrée de Map dans l’ordre d’insertion, avec la valeur, la clé et la Map.
Version : ECMAScript 2015 onward; example target: Node.js 24.22.2
Syntaxe
map.forEach(callbackFn[, thisArg])map.forEach(callbackFn, thisArg?) appelle callbackFn(value, key, map) pour chaque entrée non supprimée puis renvoie undefined. Les arguments commencent par la valeur, contrairement à entries(). Le thisArg facultatif devient this selon les règles ordinaires ; une flèche l’ignore par son this lexical.
Le parcours est vivant, pas une capture. Une entrée supprimée avant sa visite est sautée ; supprimée puis rajoutée, elle peut être visitée à sa nouvelle position, comme une entrée ajoutée avant la fin. Modifier une clé pas encore visitée transmet sa nouvelle valeur.
Un callback non appelable ou un mauvais receveur lève TypeError ; une exception arrête le parcours. Aucun break intégré et les promesses ne sont pas attendues. Standard depuis ECMAScript 2015 ; utilisez for...of pour break, continue ou await séquentiel.
Exemples
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);
}Résultat
#a:1,#c:3 true a:1,c:3 true