CKTIS / JavaScript
Set.prototype.symmetricDifference — simetrična razlika množic
Če se vhodni elementi med klicem ne spremenijo, metoda symmetricDifference() vrne nov Set z vrednostmi, ki se pojavijo v natanko eni od dveh množic. Metoda sama ne spreminja vhodnih množic.
Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
set.symmetricDifference(other)Če se vhodni elementi med klicem ne spremenijo, a.symmetricDifference(b) vrne nov Set z vrednostmi, ki pripadajo a ali b, ne pa obema. Pri argumentu, podobnem množici, za njegove elemente štejejo vrednosti, ki jih zagotovi keys(). V nasprotju z enostransko razliko simetrična razlika vključuje elemente, ki so samo na eni ali samo na drugi strani. Metoda sama ne spreminja vhodnih množic.
Sprejemnik this mora biti dejanski objekt Set. Argument other je lahko objekt, podoben množici: zagotavljati mora lastnost size ter klicljivi metodi has in keys. Pretvorba size v število ne sme dati NaN, rezultat pa po odrezovanju ulomljenega dela v smeri proti ničli ne sme biti negativen. Vrednost size je torej lahko -0.5, če so izpolnjene preostale zahteve vmesnika. Algoritem preveri ta vmesnik, vrednosti pa pridobi prek keys(), ne prek has(). Vmesniku ustreza Map, katere ključi v tem primeru delujejo kot elementi; navadno polje (Array) mu ne ustreza. Lastni dostopniki in metode argumenta lahko povzročijo stranske učinke.
Algoritem kopira podatke sprejemnika pred prvim korakom iteratorja argumenta, vendar za vsak ključ, ki ga iterator vrne, preveri, ali je v tistem trenutku v sprejemniku, in ne v kopiji. Če iterator spremeni vsebino sprejemnika, ni nujno, da rezultat ustreza simetrični razliki med vrnjenimi ključi in začetno ali končno vsebino sprejemnika.
Pri nespremenjenih vhodnih podatkih rezultat najprej ohrani vrstni red vrednosti, ki se pojavijo samo v sprejemniku, nato pa vrstni red vrednosti, ki se pojavijo samo v other, kot jih vrne keys(). Primerjava sledi SameValueZero: NaN se ujema z NaN, +0 in -0 sta enakovredna, objekti pa se primerjajo po identiteti, ne po vsebini.
Metoda je del ECMAScript 2025 in ni ločen Web API. Navedena specifikacija ne vsebuje tabele združljivosti brskalnikov; pred uvedbo v ciljnem okolju preverite typeof Set.prototype.symmetricDifference === "function". Node 24 v repozitoriju ne dokazuje podpore v brskalnikih.
Primeri
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]));Rezultat
[1,4,5] [1,2,3] [3,4,2,5]
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.