Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Set.prototype.symmetricDifference — różnica symetryczna zbiorów

Jeśli elementy wejściowe nie zmieniają się podczas wywołania, metoda symmetricDifference() zwraca nowy Set z wartościami obecnymi w dokładnie jednym z dwóch zbiorów. Sama metoda nie modyfikuje wejściowych zbiorów.

Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Składnia

set.symmetricDifference(other)

Jeśli elementy wejściowe nie zmieniają się podczas wywołania, a.symmetricDifference(b) zwraca nowy Set zawierający wartości należące do a albo b, ale nie do obu. W przypadku argumentu podobnego do zbioru jego elementami są wartości dostarczane przez keys(). W przeciwieństwie do jednostronnej różnicy różnica symetryczna uwzględnia elementy unikalne dla każdej strony. Sama metoda nie modyfikuje wejściowych zbiorów.

Odbiorca this musi być rzeczywistym obiektem Set. Argument other może być obiektem podobnym do zbioru: musi udostępniać właściwość size oraz wywoływalne metody has i keys. Konwersja size na liczbę nie może dać NaN, a wynik po obcięciu części ułamkowej w kierunku zera nie może być ujemny. Dlatego size równe -0.5 jest akceptowane, jeśli pozostałe wymagania interfejsu są spełnione. Algorytm sprawdza ten interfejs, lecz wartości pobiera przez keys(), a nie przez has(). Pasuje tu Map, którego elementami są w tym kontekście klucze; zwykła tablica nie spełnia tego interfejsu. Własne akcesory i metody argumentu mogą mieć skutki uboczne.

Algorytm kopiuje dane odbiorcy przed pierwszym krokiem iteratora argumentu, ale dla każdego klucza zwróconego przez iterator sprawdza przynależność w odbiorcy w jego bieżącym stanie, a nie w kopii. Jeśli iterator zmieni zawartość odbiorcy, wynik nie musi być różnicą symetryczną kluczy zwróconych przez iterator i elementów odbiorcy ani sprzed wywołania, ani po jego zakończeniu.

Przy niezmiennych danych wejściowych wynik zachowuje najpierw kolejność wartości występujących tylko w odbiorcy, a następnie kolejność wartości występujących tylko w other, zgodną z keys(). Porównywanie odpowiada SameValueZero: NaN pasuje do NaN, +0 i -0 są równoważne, a obiekty porównuje się według tożsamości, nie zawartości.

Metoda jest częścią ECMAScript 2025, a nie osobnym Web API. Przywołana specyfikacja nie podaje tabeli zgodności przeglądarek; przed wdrożeniem sprawdź typeof Set.prototype.symmetricDifference === "function" w docelowym środowisku. Node 24 w repozytorium nie dowodzi obsługi w przeglądarkach.

Przykłady

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]));

Wynik

[1,4,5]
[1,2,3]
[3,4,2,5]

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła