Set.prototype.forEach()

Exemple interactif

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

undefined.

Paramtres

callback

La fonction qu'on souhaite excuter pour chaque lment et qui sera appele avec trois arguments :

valeurCourante, clCourante

L'lment courant appartenant l'ensemble Set. Un ensemble n'ayant pas de cl, c'est la mme valeur qui est passe pour deux arguments de la fonction de rappel.

set

L'objet Set courant (celui sur lequel forEach() a t appel).

thisArg

Paramtre optionnel. La valeur utiliser comme this lors de l'excution de callback.

Description

La mthode forEach() excute la fonction callback fournie pour chaque valeur contenue au sein de l'objet Set. Elle n'est pas appele pour les valeurs qui ont t supprimes. Cependant, elle est excute si jamais la valeur vaut undefined.

callback est appel avec trois arguments :

• la valeur de l'lment
• la cl de l'lment
• l'objet Set qui est parcouru

Les 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 faon cohrente avec les mthodes forEach() de Map et Array.

Si un paramtre thisArg est fourni, il sera pass la fonction callback lors de l'appel comme valeur this. Par dfaut, la valeur undefined sera passe comme argument this. La valeur this effectivement reue par la fonction callback est dtermine selon les rgles usuelles de dtermination de this par une fonction.

Chacune des valeurs sera traite une fois sauf si celle-ci a t supprime puis rajoute avant la fin de forEach. callback n'est pas appel pour les valeurs qui sont supprims avant le passage de la fonction. Les valeurs qui sont ajoutes avant que forEach ait parcouru l'ensemble seront traites

forEach excute la fonction callback une fois pour chaque lment de l'objet Set. Cette mthode ne renvoie pas de valeur.

Exemples

Le code qui suit permet d'enregistrer une ligne pour chaque lment 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"

Spcifications

Compatibilit des navigateurs

Voir aussi

• Array.prototype.forEach()
• Map.prototype.forEach()