CKTIS / JavaScript
Set.prototype.symmetricDifference — symetrický rozdiel množín
Ak sa vstupné prvky počas volania nemenia, metóda symmetricDifference() vráti nový Set s hodnotami, ktoré sa vyskytujú práve v jednej z dvoch množín. Vstupné množiny sama nemení.
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.symmetricDifference(other)Ak sa vstupné prvky počas volania nemenia, a.symmetricDifference(b) vráti nový Set obsahujúci hodnoty, ktoré patria do a alebo b, ale nie do oboch. Pri argumente podobnom množine sa za jeho prvky považujú hodnoty poskytované prostredníctvom keys(). Na rozdiel od jednostranného rozdielu zahŕňa symetrický rozdiel prvky, ktoré sa vyskytujú len na jednej alebo druhej strane. Metóda sama vstupné množiny nemení.
Prijímateľ this musí byť skutočný objekt Set. Argument other môže byť objekt podobný množine: musí poskytovať vlastnosť size a volateľné metódy has a keys. Prevod size na číslo nesmie dať NaN a výsledok po odseknutí desatinnej časti smerom k nule nesmie byť záporný. Hodnota size rovná -0.5 je teda prípustná, ak sú splnené ostatné požiadavky rozhrania. Algoritmus toto rozhranie overuje, hodnoty však získava cez keys(), nie cez has(). Rozhranie spĺňa Map, ktorej kľúče tu fungujú ako prvky; bežné pole mu nevyhovuje. Vlastné prístupové vlastnosti a metódy argumentu môžu mať vedľajšie účinky.
Algoritmus skopíruje údaje prijímateľa pred prvým krokom iterátora argumentu. Pri každom kľúči získanom z iterátora však overuje, či sa kľúč v tej chvíli nachádza v prijímateľovi, nie v kópii. Ak iterátor zmení obsah prijímateľa, výsledok nemusí zodpovedať symetrickému rozdielu medzi získanými kľúčmi a pôvodným ani konečným obsahom prijímateľa.
Pri nemenných vstupoch výsledok najprv zachováva poradie hodnôt vyskytujúcich sa iba v prijímateľovi a potom poradie hodnôt vyskytujúcich sa iba v other, ako ich poskytuje keys(). Porovnávanie zodpovedá SameValueZero: NaN zodpovedá NaN, +0 a -0 sú ekvivalentné a objekty sa porovnávajú podľa identity, nie obsahu.
Metóda je súčasťou ECMAScript 2025, nejde o samostatné Web API. Citovaná špecifikácia neuvádza tabuľku kompatibility prehliadačov; pred nasadením overte v cieľovom prostredí typeof Set.prototype.symmetricDifference === "function". Node 24 v repozitári nedokazuje podporu v prehliadačoch.
Príklady
const a = new Set([1, 2, 3]);
const b = new Set([3, 4, 2, 5]);
const result = a.symmetricDifference(b);
console.log(JSON.stringify([...result]));
console.log(JSON.stringify([...a]));
console.log(JSON.stringify([...b]));Výsledok
[1,4,5] [1,2,3] [3,4,2,5]
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.