La méthode forEach()
exécute une fonction donnée sur chaque élément clé-valeur de l'objet Map
dans l'ordre d'insertion.
Le code source de cet exemple interactif est disponible dans un dépôt GitHub. Si vous souhaitez contribuez à ces exemples, n'hésitez pas à cloner https://github.com/mdn/interactive-examples et à envoyer une pull request !
Syntaxe
maMap.forEach(callback[, thisArg])
Paramètres
callback
- La fonction à exécuter pour chaque élément.
thisArg
- La valeur à utiliser comme contexte
this
lors de l'exécution decallback
.
Valeur de retour
Description
La méthode forEach
exécute la fonction callback
donnée sur chacune des clés qui existe. Elle n'est pas appelée pour les clés qui ont été supprimées. En revanche, elle est appelée pour les valeurs qui sont présentes mais qui sont égales à undefined
.
callback
est appelé avec trois arguments :
- la valeur de l'élément
- la clé de l'élément
- l'objet
Map
parcouru
Si un argument thisArg
est fourni à la méthode forEach
, il sera passé au callback
quand il sera appelé et celui-ci l'utilisera comme valeur this
. Dans les autres cas, la valeur undefined
sera utilisée comme contexte this
. La valeur this
observée par la fonction callback
est déterminée selon les règles appliquées à l'opérateur this
.
Chacune des valeurs sera traitée une fois sauf si celle-ci a été supprimée puis réajoutée avant la fin de forEach
. callback
n'est pas appelé pour les valeurs qui sont supprimés avant le passage de la fonction. Les valeurs qui sont ajoutées avant que forEach
ait parcouru l'ensemble seront traitées.
forEach
exécute la fonction callback
une fois pour chaque élément de l'objet Map
: il ne renvoie pas de valeur.
Exemples
Le fragment de code suivant enregistre une ligne pour chaque élément d'un objet Map
:
function logMapElements(valeur, clé, map) {
console.log(`map.get('${clé}') = ${value}`);
}
new Map([["toto", 3], ["truc", {}], ["bidule", undefined]]).forEach(logMapElements);
// affichera dans la console :
// "map.get('toto') = 3"
// "map.get('truc') = [object Object]"
// "map.get('bidule') = undefined"
Spécifications
Spécification | État | Commentaires |
---|---|---|
ECMAScript 2015 (6th Edition, ECMA-262) La définition de 'Map.prototype.forEach' dans cette spécification. |
Standard | Définition initiale. |
ECMAScript (ECMA-262) La définition de 'Map.prototype.forEach' dans cette spécification. |
Standard évolutif |
Compatibilité des navigateurs
BCD tables only load in the browser