CKTIS / JavaScript
Set.prototype.union — zjednotenie množín
Set.prototype.union(other) vytvorí nový Set s hodnotami z oboch množín bez duplicít. Zachová poradie ľavej množiny a potom pridá nové hodnoty z other. Argument musí podporovať protokol objektov podobných množine; nestačí, aby bol iba iterovateľný.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
set.union(other)Set.prototype.union(other) vypočíta zjednotenie: vráti nový Set obsahujúci hodnoty, ktoré sa vyskytujú aspoň v jednom zo vstupov. Najprv zachová poradie vloženia prijímateľa a potom pridá chýbajúce hodnoty v poradí, ktoré vráti other.keys(). Samotný algoritmus vstupné množiny nemení; vlastné gettery a metódy objektu other však môžu mať vedľajšie účinky.
Prijímateľ musí byť skutočný objekt Set s internými dátami množiny. other môže byť objekt podobný množine: musí poskytovať platné size a volateľné metódy has a keys; keys() musí vracať iterátor. union overí has, ale nevolá ho. Map tento protokol spĺňa — použijú sa jej kľúče. Samotná iterovateľnosť nestačí: bežné pole nie je platný argument; použite new Set(array).
Duplicitné hodnoty sa určujú podľa sémantiky SameValueZero: hodnoty NaN sa považujú za rovnaké, rovnako ako +0 a -0; objekty sa porovnávajú podľa identity, nie obsahu. Výsledok je plytký: obsahuje rovnaké referencie na objekty. Je to bežný Set, aj keď je prijímateľ inštanciou podtriedy.
Metóda je súčasťou ECMAScript 2025, nie Web API. Zo špecifikácie jazyka nemožno potvrdiť podporu v konkrétnom prehliadači; ani prítomnosť Node 24 v repozitári nedokazuje podporu v prehliadačoch. Pred použitím overte typeof Set.prototype.union === "function" v cieľovom prostredí a v prípade potreby poskytnite kompatibilnú náhradnú implementáciu.
Prí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ýsledok
[3,1,2] [3,1] [1,2] true
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.