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

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.

Zdroje