CKTIS / JavaScript
Set.prototype.symmetricDifference — symetrický rozdíl množin
Pokud se vstupní prvky během volání nemění, metoda symmetricDifference() vrací nový Set s hodnotami, které se vyskytují právě v jedné ze dvou množin. Vstupní množiny sama nemění.
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.symmetricDifference(other)Pokud se vstupní prvky během volání nemění, a.symmetricDifference(b) vrátí nový Set obsahující hodnoty, které patří do a nebo b, ale ne do obou. U argumentu podobného množině se za jeho prvky považují hodnoty poskytované prostřednictvím keys(). Na rozdíl od jednostranného rozdílu zahrnuje symetrický rozdíl prvky, které se vyskytují jen na jedné či druhé straně. Metoda sama vstupní množiny nemění.
Příjemce this musí být skutečný objekt Set. Argument other může být objekt podobný množině: musí poskytovat vlastnost size a volatelné metody has a keys. Převod size na číslo nesmí dát NaN a výsledek po odříznutí desetinné části směrem k nule nesmí být záporný. Hodnota size rovná -0.5 je tedy přípustná, pokud jsou splněny ostatní požadavky rozhraní. Algoritmus toto rozhraní ověří, hodnoty však získává přes keys(), nikoli přes has(). Rozhraní splňuje Map, jejíž klíče zde fungují jako prvky; běžné pole mu nevyhovuje. Vlastní přístupové vlastnosti a metody argumentu mohou mít vedlejší účinky.
Algoritmus zkopíruje data příjemce před prvním krokem iterátoru argumentu. U každého klíče získaného z iterátoru ale ověřuje, zda je v tu chvíli obsažen v příjemci, nikoli v kopii. Pokud iterátor změní obsah příjemce, výsledek nemusí odpovídat symetrickému rozdílu mezi získanými klíči a původním ani konečným obsahem příjemce.
Při neměnných vstupech výsledek nejprve zachovává pořadí hodnot vyskytujících se pouze v příjemci a poté pořadí hodnot vyskytujících se pouze v other, jak je poskytuje keys(). Porovnávání odpovídá SameValueZero: NaN odpovídá NaN, +0 a -0 jsou ekvivalentní a objekty se porovnávají podle identity, nikoli obsahu.
Metoda je součástí ECMAScript 2025, nejde o samostatné Web API. Citovaná specifikace neuvádí tabulku kompatibility prohlížečů; před nasazením ověřte v cílovém prostředí typeof Set.prototype.symmetricDifference === "function". Node 24 v repozitáři nedokazuje podporu v prohlížečích.
Pří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ýsledek
[1,4,5] [1,2,3] [3,4,2,5]
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.