CKTIS / JavaScript
Set.prototype.add — přidání hodnoty do množiny
Set.prototype.add(value) přidá do množiny jednu hodnotu, pokud v ní ještě není. Upraví existující objekt Set a vrátí tentýž objekt, takže lze volání řetězit.
Verze: 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) přidá jednu hodnotu do existujícího objektu Set. Pokud už je hodnota přítomná, množina zůstane beze změny. Metoda vždy vrací tutéž množinu, nikoli logickou hodnotu, která by říkala, zda k vložení došlo; lze proto napsat set.add(a).add(b). Nová hodnota se zařadí na konec pořadí iterace; opětovné přidání již přítomné hodnoty její pozici nezmění.
Jedinečnost se řídí porovnáním SameValueZero: NaN je duplicitou NaN a -0 i +0 představují stejný prvek; nula se ukládá jako +0. Objekty se porovnávají podle identity, nikoli podle obsahu. Dva samostatně vytvořené objekty {} jsou tedy různé prvky, ale opětovné přidání stejné reference nezvýší size.
add nerozbalí pole ani jiné iterovatelné objekty: set.add([1, 2]) přidá jedno pole. Volání bez argumentu přidá undefined. Metoda vyžaduje příjemce s interními daty Set; Set.prototype.add.call({}, 1) vyvolá TypeError.
Pří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ýsledek
true 2 blue,green 4
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.