Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła