CKTIS / JavaScript
Set.prototype.isSupersetOf — sprawdzanie nadzbioru
Metoda isSupersetOf() sprawdza, czy Set zawiera wszystkie elementy drugiej kolekcji o interfejsie zbioru. Zwraca wartość logiczną; równe zbiory również spełniają warunek, więc nie jest to test nadzbioru właściwego.
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.isSupersetOf(other)set.isSupersetOf(other) zwraca true, gdy set zawiera każdy element other; w przeciwnym razie zwraca false. Równość zbiorów jest dozwolona, a każdy zbiór jest nadzbiorem pustego Set. Metoda sama nie modyfikuje zbiorów.
Odbiorca set musi być rzeczywistym obiektem Set; samo udostępnienie podobnych metod nie wystarczy. Argument other może być obiektem o interfejsie zbioru: udostępnia właściwość size oraz wywoływalne metody has() i keys(). Metoda konwertuje wartość size na liczbę, odrzuca NaN, obcina wartości skończone do liczby całkowitej w kierunku zera, a następnie odrzuca wynik, jeśli jest ujemny. Na przykład napis "1" jest akceptowany jako rozmiar równy 1. Pasują tu Set i Map — dla Map sprawdzane są klucze. Zwykła tablica nie spełnia tego kontraktu; użyj new Set(array).
Po sprawdzeniu argumentu metoda zwraca false, jeśli rozmiar odbiorcy jest mniejszy niż rozmiar other. W przeciwnym razie przechodzi po other.keys() i kończy przy pierwszym brakującym elemencie. other.has() musi istnieć, ale nie jest wywoływane przez ten algorytm. Porównywanie odpowiada semantyce SameValueZero: NaN pasuje do NaN, +0 i -0 są równoważne, a obiekty porównuje się według tożsamości. Własne gettery i iteratory mogą wykonywać kod ze skutkami ubocznymi.
Metoda jest częścią ECMAScript 2025. Specyfikacja języka nie potwierdza obsługi w konkretnej przeglądarce; przed użyciem sprawdź typeof Set.prototype.isSupersetOf === 'function' w środowisku docelowym. Wersja Node używana w repozytorium nie dowodzi obsługi w przeglądarkach.
Przykłady
const available = new Set(['read', 'write', 'share']);
const required = new Set(['read', 'write']);
console.log(available.isSupersetOf(required));
console.log(required.isSupersetOf(available));
console.log(available.isSupersetOf(available));
console.log(available.isSupersetOf(new Set()));Wynik
true false true true
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.