Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

Set.prototype.symmetricDifference — simetrična razlika skupova

Ako se ulazni elementi ne mijenjaju tijekom poziva, metoda symmetricDifference() vraća novi Set s vrijednostima koje se pojavljuju u točno jednom od dvaju skupova. Metoda sama ne mijenja ulazne skupove.

Verzija: 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)

Ako se ulazni elementi ne mijenjaju tijekom poziva, a.symmetricDifference(b) vraća novi Set s vrijednostima koje pripadaju skupu a ili b, ali ne i obama. Ako je argument objekt nalik skupu, njegovim se elementima smatraju vrijednosti koje daje keys(). Za razliku od jednostrane razlike, simetrična razlika uključuje elemente koji se pojavljuju samo na jednoj ili samo na drugoj strani. Metoda sama ne mijenja ulazne skupove.

Primatelj this mora biti stvarni objekt Set. Argument other može biti objekt nalik skupu: mora imati svojstvo size te metode has i keys koje se mogu pozvati. Pretvorba vrijednosti size u broj ne smije dati NaN, a rezultat nakon odbacivanja razlomljenog dijela prema nuli ne smije biti negativan. Zato je vrijednost -0.5 prihvatljiva za size ako su ispunjeni ostali zahtjevi sučelja. Algoritam provjerava to sučelje, ali vrijednosti dohvaća putem keys(), a ne putem has(). Map zadovoljava uvjete; njezini ključevi ovdje služe kao elementi. Običan niz ne zadovoljava ovo sučelje. Prilagođeni pristupnici i metode argumenta mogu imati nuspojave.

Algoritam kopira podatke primatelja prije prvog koraka iteratora argumenta. Za svaki ključ koji iterator vrati ipak provjerava nalazi li se taj ključ u tom trenutku u primatelju, a ne u kopiji. Ako iterator promijeni sadržaj primatelja, rezultat ne mora odgovarati simetričnoj razlici između vraćenih ključeva i početnog ili završnog sadržaja primatelja.

Ako se ulazni podaci ne mijenjaju, rezultat najprije zadržava redoslijed vrijednosti koje se pojavljuju samo u primatelju, a zatim redoslijed vrijednosti koje se pojavljuju samo u other, prema redoslijedu koji daje keys(). Usporedba slijedi SameValueZero: NaN odgovara vrijednosti NaN, +0 i -0 ekvivalentni su, a objekti se uspoređuju prema identitetu, a ne sadržaju.

Metoda je dio ECMAScript 2025, a ne zaseban Web API. Navedena specifikacija ne sadrži tablicu kompatibilnosti preglednika; prije implementacije u ciljnom okruženju provjerite typeof Set.prototype.symmetricDifference === "function". Node 24 u repozitoriju ne dokazuje podršku u preglednicima.

Primjeri

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]

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori