Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje