Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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.

Sources