CKTIS / JavaScript
Set.prototype.add — ajouter une valeur à un ensemble
Set.prototype.add(value) ajoute une seule valeur à un ensemble si elle n’y figure pas déjà. La méthode modifie le Set existant et renvoie ce même objet, ce qui permet d’enchaîner les appels.
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.add(value)set.add(value) ajoute une valeur à un objet Set existant. Si la valeur est déjà présente, l’ensemble reste inchangé. La méthode renvoie toujours le même ensemble, et non une valeur booléenne indiquant si l’insertion a eu lieu ; on peut donc écrire set.add(a).add(b). Une nouvelle valeur est placée à la fin de l’ordre d’itération ; ajouter à nouveau une valeur déjà présente ne change pas sa position.
L’unicité repose sur la comparaison SameValueZero : NaN est un doublon de NaN, et -0 et +0 représentent le même élément ; zéro est stocké sous la forme +0. Les objets sont comparés par identité, et non par contenu. Deux objets {} créés séparément sont donc des éléments distincts, mais ajouter à nouveau la même référence n’augmente pas size.
add ne développe pas les tableaux ni les autres objets itérables : set.add([1, 2]) ajoute un seul tableau. Un appel sans argument ajoute undefined. La méthode exige un récepteur doté des données internes d’un Set ; Set.prototype.add.call({}, 1) déclenche une TypeError.
Exemples
const values = new Set();
const returned = values.add("blue").add("green").add("blue");
console.log(returned === values);
console.log(values.size);
console.log([...values].join(","));
values.add(NaN).add(NaN).add(-0).add(+0);
console.log(values.size);Résultat
true 2 blue,green 4
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.