CKTIS / JavaScript
Set.prototype.isSupersetOf — overenie nadmnožiny
Metóda isSupersetOf() overuje, či Set obsahuje každý prvok inej kolekcie podobnej množine. Vráti logickú hodnotu; podmienku spĺňajú aj rovnaké množiny, nejde teda o test vlastnej nadmnožiny.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
set.isSupersetOf(other)set.isSupersetOf(other) vráti true, keď set obsahuje každý prvok other, inak vráti false. Podmienku spĺňajú aj rovnaké množiny a každá množina je nadmnožinou prázdneho Set. Metóda sama množiny nemení.
Prijímateľ set musí byť skutočný objekt Set; nestačí iba poskytnúť podobné metódy. Argument other môže byť objekt podobný množine: sprístupňuje vlastnosť size a volateľné metódy has() a keys(). Metóda prevedie size na číslo, odmietne NaN, skráti konečné hodnoty na celé číslo smerom k nule a potom odmietne záporný výsledok. Napríklad reťazec "1" prijme ako veľkosť 1. Požiadavkám vyhovujú Set aj Map — pri Map sa používajú jej kľúče. Bežné pole túto zmluvu nespĺňa; použite new Set(array).
Po overení argumentu metóda vráti false, ak je veľkosť prijímateľa menšia než veľkosť other. Inak prechádza other.keys() a skončí pri prvom chýbajúcom prvku. other.has() musí existovať, ale tento algoritmus ju nevolá. Príslušnosť sa riadi sémantikou SameValueZero: NaN zodpovedá NaN, +0 a -0 sú rovnocenné a objekty sa porovnávajú podľa identity. Vlastné gettery a iterátory môžu spúšťať kód s vedľajšími účinkami.
Metóda je súčasťou ECMAScript 2025. Jazyková špecifikácia nezaručuje podporu v konkrétnom prehliadači; pred použitím v cieľovom prostredí overte typeof Set.prototype.isSupersetOf === 'function'. Verzia Node použitá v repozitári nedokazuje podporu v prehliadačoch.
Príklady
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()));Výsledok
true false true true
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.