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

CKTIS / JavaScript

Set.prototype.union — sjednocení množin

Set.prototype.union(other) vytvoří nový Set s hodnotami z obou množin, bez duplicit. Zachová pořadí levé množiny a potom přidá nové hodnoty z other. Argument musí podporovat protokol objektů podobných množině; nestačí, aby byl pouze iterovatelný.

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.union(other)

Set.prototype.union(other) vypočítá sjednocení: vrátí nový Set obsahující hodnoty, které se vyskytují alespoň v jednom ze vstupů. Nejprve zachová pořadí vložení příjemce a potom přidá chybějící hodnoty v pořadí, které vrátí other.keys(). Samotný algoritmus vstupní množiny nemění; vlastní gettery a metody objektu other však mohou mít vedlejší účinky.

Příjemcem musí být skutečný objekt Set s interními daty množiny. other může být objekt podobný množině: musí poskytovat platné size a volatelné metody has a keys; keys() musí vracet iterátor. union ověří has, ale nevolá ho. Map tento protokol splňuje — použijí se její klíče. Samotná iterovatelnost nestačí: běžné pole není platný argument; použijte new Set(array).

Duplicitní hodnoty se určují podle sémantiky SameValueZero: hodnoty NaN se považují za stejné, stejně jako +0 a -0; objekty se porovnávají podle identity, nikoli obsahu. Výsledek je mělký: obsahuje stejné reference na objekty. Jde o běžný Set, i když je příjemce instancí podtřídy.

Metoda je součástí ECMAScript 2025, nikoli Web API. Ze specifikace jazyka nelze potvrdit podporu v konkrétním prohlížeči; ani přítomnost Node 24 v repozitáři nedokládá podporu v prohlížečích. Před použitím ověřte typeof Set.prototype.union === "function" v cílovém prostředí a v případě potřeby poskytněte kompatibilní náhradní implementaci.

Příklady

const left = new Set([3, 1]);
const right = new Set([1, 2]);
const result = left.union(right);

console.log(JSON.stringify([...result]));
console.log(JSON.stringify([...left]));
console.log(JSON.stringify([...right]));
console.log(result !== left && result !== right);

Výsledek

[3,1,2]
[3,1]
[1,2]
true

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