CKTIS / JavaScript
Set.prototype.isSupersetOf — ověření nadmnožiny
Metoda isSupersetOf() ověřuje, zda Set obsahuje každý prvek jiné kolekce podobné množině. Vrací logickou hodnotu; podmínku splňují i stejné množiny, nejde tedy o test vlastní nadmnož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.isSupersetOf(other)set.isSupersetOf(other) vrací true, když set obsahuje každý prvek other, jinak vrací false. Podmínku splňují i stejné množiny a každá množina je nadmnožinou prázdného Set. Metoda sama množiny nemění.
Příjemce set musí být skutečný objekt Set; nestačí pouze poskytnout podobné metody. Argument other může být objekt podobný množině: zpřístupňuje vlastnost size a volatelné metody has() a keys(). Metoda převede size na číslo, odmítne NaN, ořízne konečné hodnoty na celé číslo směrem k nule a poté odmítne záporný výsledek. Například řetězec "1" přijme jako velikost 1. Těmto požadavkům vyhovují Set i Map — u Map se používají její klíče. Běžné pole tuto smlouvu nesplňuje; použijte new Set(array).
Po ověření argumentu metoda vrátí false, pokud je velikost příjemce menší než velikost other. Jinak prochází other.keys() a skončí u prvního chybějícího prvku. other.has() musí existovat, ale tento algoritmus ji nevolá. Příslušnost se řídí sémantikou SameValueZero: NaN odpovídá NaN, +0 a -0 jsou rovnocenné a objekty se porovnávají podle identity. Vlastní gettery a iterátory mohou spouštět kód s vedlejšími účinky.
Metoda je součástí ECMAScript 2025. Jazyková specifikace nezaručuje podporu v konkrétním prohlížeči; před použitím v cílovém prostředí ověřte typeof Set.prototype.isSupersetOf === 'function'. Verze Node použitá v repozitáři nedokazuje podporu v prohlížečích.
Pří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ý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.