Baseline Widely available
La méthode forEach()
permet d'exécuter une fonction donnée, une fois pour chaque valeur de l'ensemble Set
. L'ordre appliqué est celui dans lequel les valeurs ont été ajoutées à l'ensemble.
function logSetElements(value1, value2, set) {
console.log(`s[${value1}] = ${value2}`);
}
new Set(["foo", "bar", undefined]).forEach(logSetElements);
// Expected output: "s[foo] = foo"
// Expected output: "s[bar] = bar"
// Expected output: "s[undefined] = undefined"
Syntaxe
monSet.forEach(callback[, thisArg])
Valeur de retour
Paramètres
callback
La fonction qu'on souhaite exécuter pour chaque élément et qui sera appelée avec trois arguments :
valeurCourante
, cléCourante
L'élément courant appartenant à l'ensemble Set
. Un ensemble n'ayant pas de clé, c'est la même valeur qui est passée pour deux arguments de la fonction de rappel.
set
L'objet Set
courant (celui sur lequel forEach()
a été appelé).
thisArg
Paramètre optionnel. La valeur à utiliser comme this
lors de l'exécution de callback
.
La méthode forEach()
exécute la fonction callback
fournie pour chaque valeur contenue au sein de l'objet Set
. Elle n'est pas appelée pour les valeurs qui ont été supprimées. Cependant, elle est exécutée si jamais la valeur vaut undefined
.
callback
est appelé avec trois arguments :
Set
qui est parcouruLes objets Set
n'ont pas de clé (key). Cependant les deux premiers arguments correspondent à la valeur contenue dans l'objet Set
. Cela permet d'utiliser les fonctions callback de façon cohérente avec les méthodes forEach()
de Map
et Array
.
Si un paramètre thisArg
est fourni, il sera passé à la fonction callback
lors de l'appel comme valeur this
. Par défaut, la valeur undefined
sera passée comme argument this
. La valeur this
effectivement reçue par la fonction callback
est déterminée selon les règles usuelles de détermination de this
par une fonction.
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 Set
. Cette méthode ne renvoie pas de valeur.
Le code qui suit permet d'enregistrer une ligne pour chaque élément contenu dans l'objet Set
:
function logSetElements(valeur1, valeur2, set) {
console.log("s[" + valeur1 + "] = " + valeur2);
}
new Set(["toto", "truc", undefined]).forEach(logSetElements);
// affichera :
// "s[toto] = toto"
// "s[truc] = truc"
// "s[undefined] = undefined"
Spécifications Compatibilité des navigateurs Voir aussi
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4