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.