Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

Set.prototype.isSubsetOf — testování podmnožin

Set.prototype.isSubsetOf ověřuje, zda se každý prvek množiny nachází v jiné množině nebo objektu podobném množině. Vrací boolean; tuto podmínku splňují i stejné množiny.

Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

set.isSubsetOf(other)

set.isSubsetOf(other) vrací true, pokud každý prvek set patří do other; jinak vrací false. Nejde o test vlastní podmnožiny: množina je podmnožinou sama sebe. Prázdná množina je podmnožinou každé platné množiny. Metoda samotné množiny nemění.

Příjemce set musí být skutečný objekt Set. Argument other může být Set nebo objekt s vlastností size a volatelnými metodami has a keys, například Map, u něhož se kontrolují klíče. Samotná iterovatelnost nestačí: pole není platným argumentem. Metoda vyžaduje volatelnou metodu keys, přestože ji nevolá.

Po ověření argumentu metoda vrátí false, pokud počet prvků interně uložených v set převyšuje velikost other. Při tomto porovnání metoda nečte vlastnost set.size. Jinak kontroluje prvky pomocí other.has a skončí při prvním chybějícím prvku. U běžných množin se objekty porovnávají podle identity, nikoli podle obsahu. Vlastní gettery a metody argumentu mohou mít vedlejší účinky nebo vyvolat výjimky.

Metoda je součástí ECMAScript 2025, nikoli Web APIs. Specifikace nepotvrzuje podporu v konkrétním prohlížeči; nedokazuje ji ani přítomnost Node 24 v repozitáři. V cílovém prostředí ověřte typeof Set.prototype.isSubsetOf === "function".

Příklady

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));

Výsledek

true
false
true
true

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje