CKTIS / JavaScript
Set.prototype.add — dodajanje vrednosti v množico
Set.prototype.add(value) doda eno vrednost v množico, če je v njej še ni. Spremeni obstoječi Set in vrne isti objekt, zato je klice mogoče verižno povezati.
Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
set.add(value)set.add(value) doda eno vrednost v obstoječi objekt Set. Če je vrednost že prisotna, množica ostane nespremenjena. Metoda vedno vrne isto množico, ne pa logične vrednosti, ki bi povedala, ali je prišlo do dodajanja; zato lahko zapišete set.add(a).add(b). Nova vrednost se uvrsti na konec vrstnega reda iteracije; ponovno dodajanje že prisotne vrednosti ne spremeni njenega položaja.
Edinstvenost temelji na primerjavi SameValueZero: NaN je dvojnik vrednosti NaN, -0 in +0 pa predstavljata isti element; ničla se shrani kot +0. Objekti se primerjajo po istovetnosti, ne po vsebini. Dva ločeno ustvarjena objekta {} sta zato različna elementa, ponovno dodajanje iste reference pa ne poveča size.
add ne razširi polj ali drugih iterabilnih objektov: set.add([1, 2]) doda eno polje. Klic brez argumenta doda undefined. Metoda zahteva prejemnika z notranjimi podatki Set; Set.prototype.add.call({}, 1) sproži TypeError.
Primeri
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);Rezultat
true 2 blue,green 4
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.