CKTIS / JavaScript
Set.prototype.difference — różnica zbiorów
Metoda difference() zwraca nowy Set z elementami zbioru wywołującego, których nie ma w drugim zbiorze. Zachowuje ich kolejność i sama nie modyfikuje zbiorów wejściowych.
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.difference(other)Set.prototype.difference oblicza różnicę zbiorów: a.difference(b) zawiera elementy a, których nie ma w b. Kolejność operandów ma znaczenie — nie jest to różnica symetryczna. Wynikiem jest nowy Set, zachowujący kolejność wstawiania pozostałych elementów a; sama operacja nie zmienia zbiorów wejściowych.
Odbiorca this musi być rzeczywistym obiektem Set. Argument other może być zbiorem lub obiektem zgodnym z protokołem zbioropodobnym: musi udostępniać poprawne size oraz wywoływalne has() i keys(). Map spełnia ten protokół, a porównywane są jego klucze. Sama iterowalność nie wystarcza: tablicę należy najpierw przekazać do new Set(...).
Dla zwykłych zbiorów obowiązuje porównywanie SameValueZero: NaN odpowiada NaN, +0 i -0 są równoważne, a obiekty porównuje się według tożsamości, nie zawartości. Zależnie od rozmiarów algorytm używa other.has() albo iteruje po other.keys(). Niestandardowe metody i gettery mogą więc wywoływać efekty uboczne; nie należy zakładać ich kolejności wywołań niezależnej od rozmiaru.
Metoda należy do ECMAScript 2025, a nie do Web APIs. Przy wdrożeniu sprawdź typeof Set.prototype.difference === "function" w docelowym środowisku. Specyfikacja nie stanowi tabeli obsługi przeglądarek, a obecność Node 24 w repozytorium nie dowodzi obsługi w przeglądarce.
Przykłady
const available = new Set([3, 1, 2]);
const reserved = new Set([1, 4]);
const remaining = available.difference(reserved);
console.log(JSON.stringify([...remaining]));
console.log(JSON.stringify([...available]));
console.log(JSON.stringify([...reserved]));Wynik
[3,2] [3,1,2] [1,4]
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.