Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Set.prototype.isSubsetOf — sprawdzanie podzbioru

Set.prototype.isSubsetOf sprawdza, czy każdy element zbioru występuje w drugim zbiorze lub obiekcie zgodnym z protokołem zbioru. Zwraca boolean; równe zbiory także spełniają ten warunek.

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.isSubsetOf(other)

set.isSubsetOf(other) zwraca true, gdy każdy element set należy do other; w przeciwnym razie zwraca false. Nie sprawdza podzbioru właściwego: zbiór jest podzbiorem samego siebie. Pusty zbiór jest podzbiorem każdego poprawnego zbioru. Sama metoda nie modyfikuje zbiorów.

Odbiorca set musi być rzeczywistym obiektem Set. Argument other może być obiektem Set lub obiektem z właściwością size oraz metodami has i keys, np. Map, którego klucze są sprawdzane. Sama iterowalność nie wystarcza: tablica nie jest poprawnym argumentem. Metoda wymaga wywoływalnej keys, chociaż jej nie wywołuje.

Po sprawdzeniu argumentu metoda zwraca false, jeśli liczba elementów przechowywanych wewnętrznie w set przekracza rozmiar other. Nie odczytuje przy tym właściwości set.size. W przeciwnym razie sprawdza elementy przez other.has i kończy po pierwszym braku. Dla zwykłych zbiorów obiekty są porównywane według tożsamości, nie zawartości. Własne gettery i metody argumentu mogą mieć skutki uboczne lub rzucać wyjątki.

Metoda należy do ECMAScript 2025, a nie do Web APIs. Specyfikacja nie potwierdza zgodności konkretnej przeglądarki; obecność Node 24 w repozytorium również jej nie dowodzi. W docelowym środowisku sprawdź typeof Set.prototype.isSubsetOf === "function".

Przykłady

const required = new Set(["read"]);
const granted = new Set(["read", "write"]);

console.log(required.isSubsetOf(granted));
console.log(granted.isSubsetOf(required));
console.log(required.isSubsetOf(required));
console.log(new Set().isSubsetOf(granted));

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