CKTIS / JavaScript
Set.prototype.isDisjointFrom — sprawdzanie rozłączności zbiorów
Metoda Set.prototype.isDisjointFrom sprawdza, czy zbiór nie ma wspólnych elementów z innym zbiorem lub obiektem zgodnym z protokołem zbioru. Zwraca wartość logiczną, a nie nowy zbiór.
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.isDisjointFrom(other)set.isDisjointFrom(other) zwraca true, gdy zbiory nie mają wspólnego elementu, oraz false, gdy znajdzie choć jeden. Dla zwykłych zbiorów Set pusty zbiór jest rozłączny z każdym zbiorem, także pustym. Metoda nie tworzy zbioru wynikowego i sama nie modyfikuje argumentów.
Odbiorca set musi być rzeczywistym obiektem Set; samo udostępnienie podobnych metod nie wystarczy. Argument other może być obiektem zgodnym z protokołem zbioru: musi udostępniać poprawne size oraz wywoływalne has i keys. Pasuje tu Set lub Map, przy czym dla Map sprawdzane są klucze. Sama iterowalność nie wystarcza: zwykła tablica nie jest poprawnym argumentem; można użyć new Set(array).
Dla zwykłych zbiorów porównywanie odpowiada regule SameValueZero: NaN pasuje do NaN, a +0 do -0; obiekty są porównywane według tożsamości, nie zawartości. Metoda porównuje wewnętrzną liczbę elementów set z rozmiarem uzyskanym z other.size; nie odczytuje publicznej właściwości set.size. Jeśli ta wewnętrzna liczba jest mniejsza lub równa rozmiarowi other, metoda przechodzi po set i wywołuje other.has; w przeciwnym razie pobiera elementy przez other.keys. Kończy po znalezieniu wspólnego elementu. Własne gettery lub metody other mogą mieć skutki uboczne lub zgłaszać wyjątki, więc należy unikać modyfikowania zbiorów podczas sprawdzania.
Metoda należy do ECMAScript 2025, a nie do Web APIs. Specyfikacja języka nie potwierdza obsługi w konkretnej wersji przeglądarki. Przed użyciem w docelowym środowisku sprawdź typeof Set.prototype.isDisjointFrom === "function"; obecność Node 24 w repozytorium nie dowodzi obsługi w przeglądarce.
Przykłady
const selected = new Set([2, 4]);
const available = new Set([1, 3]);
const reserved = new Set([4, 6]);
console.log(selected.isDisjointFrom(available));
console.log(selected.isDisjointFrom(reserved));
console.log(selected.isDisjointFrom(new Set()));Wynik
true false true
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.