CKTIS / JavaScript
Set.prototype.add — pridanie hodnoty do množiny
Set.prototype.add(value) pridá do množiny jednu hodnotu, ak sa v nej ešte nenachádza. Upraví existujúci objekt Set a vráti ten istý objekt, takže volania možno reťaziť.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
set.add(value)set.add(value) pridá jednu hodnotu do existujúceho objektu Set. Ak je hodnota už prítomná, množina zostane nezmenená. Metóda vždy vracia tú istú množinu, nie logickú hodnotu, ktorá by oznamovala, či k vloženiu došlo; preto možno napísať set.add(a).add(b). Nová hodnota sa zaradí na koniec poradia iterácie; opätovné pridanie už prítomnej hodnoty jej pozíciu nezmení.
Jedinečnosť sa riadi porovnaním SameValueZero: NaN je duplicitou NaN a -0 aj +0 predstavujú ten istý prvok; nula sa ukladá ako +0. Objekty sa porovnávajú podľa identity, nie podľa obsahu. Dva samostatne vytvorené objekty {} sú teda rôzne prvky, ale opätovné pridanie tej istej referencie nezvýši size.
add nerozbaľuje polia ani iné iterovateľné objekty: set.add([1, 2]) pridá jedno pole. Volanie bez argumentu pridá undefined. Metóda vyžaduje prijímač s internými údajmi Set; Set.prototype.add.call({}, 1) vyvolá TypeError.
Príklady
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);Výsledok
true 2 blue,green 4
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.