CKTIS / JavaScript
Set.prototype.forEach — exécuter une fonction de rappel pour les valeurs d’un ensemble
Set.prototype.forEach appelle une fonction pour les valeurs d’un ensemble dans leur ordre d’insertion. Elle transmet deux fois la valeur ainsi que l’ensemble lui-même, et la méthode renvoie undefined.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
set.forEach(callback[, thisArg])
callback(value, valueAgain, set)Set.prototype.forEach appelle callback pour les valeurs de l’ensemble dans leur ordre d’insertion. La méthode renvoie undefined ; elle ne crée pas de nouvel ensemble et ignore les valeurs renvoyées par la fonction de rappel.
Les arguments de la fonction de rappel sont (value, valueAgain, set) : les deux premiers contiennent la même valeur et le troisième est l’ensemble parcouru. Le deuxième argument n’est pas un index. L’argument facultatif thisArg est fourni comme this de la fonction de rappel ; une fonction fléchée conserve son this lexical.
L’itération tient compte des modifications : elle ignore les valeurs supprimées avant leur visite et visite les nouvelles valeurs ajoutées avant la fin. Une valeur déjà visitée, puis supprimée et ajoutée à nouveau, peut être visitée une seconde fois. De telles modifications peuvent empêcher l’itération de se terminer.
return termine uniquement l’appel en cours de la fonction de rappel, pas le parcours. Utilisez for...of si vous avez besoin de break. Une exception interrompt le parcours. Un récepteur incompatible dépourvu de données internes Set, ou un callback non appelable, provoque un TypeError.
Exemples
const values = new Set([3, 1, 3]);
const lines = [];
const result = values.forEach((value, valueAgain, set) => {
lines.push(`${value}|${valueAgain}|${set === values}`);
});
console.log(lines.join('\n'));
console.log(String(result));Résultat
3|3|true 1|1|true undefined
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.