Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje