CKTIS / JavaScript
Set.prototype.add — dodavanje vrijednosti u skup
Set.prototype.add(value) dodaje jednu vrijednost u skup ako se ondje već ne nalazi. Mijenja postojeći Set i vraća isti objekt, pa se pozivi mogu ulančavati.
Verzija: 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) dodaje jednu vrijednost u postojeći objekt Set. Ako je vrijednost već prisutna, skup ostaje nepromijenjen. Metoda uvijek vraća isti skup, a ne logičku vrijednost koja bi označavala je li vrijednost dodana, pa se može napisati set.add(a).add(b). Nova se vrijednost smješta na kraj redoslijeda iteracije; ponovno dodavanje postojeće vrijednosti ne mijenja njezin položaj.
Jedinstvenost se temelji na usporedbi SameValueZero: NaN je duplikat vrijednosti NaN, a -0 i +0 predstavljaju isti element; nula se pohranjuje kao +0. Objekti se uspoređuju prema identitetu, a ne sadržaju. Dva zasebno stvorena objekta {} zato su različiti elementi, ali ponovno dodavanje iste reference ne povećava size.
add ne proširuje nizove ni druge iterabilne objekte: set.add([1, 2]) dodaje jedan niz. Poziv bez argumenata dodaje undefined. Metoda zahtijeva primatelja s internim podacima Set; Set.prototype.add.call({}, 1) baca TypeError.
Primjeri
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
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.