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.