Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje