CKTIS / JavaScript
Set.prototype.isSupersetOf — preverjanje nadmnožice
Metoda isSupersetOf() preveri, ali Set vsebuje vsak element druge zbirke, podobne množici. Vrne logično vrednost; pogoj izpolnjujejo tudi enake množice, zato ne gre za preizkus prave nadmnožice.
Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
set.isSupersetOf(other)set.isSupersetOf(other) vrne true, kadar set vsebuje vsak element množice other, sicer pa vrne false. Pogoj izpolnjujejo tudi enake množice, vsaka množica pa je nadmnožica praznega Set. Metoda sama množic ne spreminja.
Sprejemnik set mora biti pravi objekt Set; zgolj zagotavljanje podobnih metod ne zadostuje. Argument other je lahko objekt, podoben množici: ima lastnost size ter klicljivi metodi has() in keys(). Metoda pretvori size v število, zavrne NaN, končne vrednosti odreže proti ničli in nato zavrne negativen rezultat. Niz "1" na primer sprejme kot velikost 1. Tem zahtevam ustrezata tako Set kot Map — pri Map se uporabijo njeni ključi. Navadno polje (angl. array) teh zahtev ne izpolnjuje; uporabi new Set(array).
Po preverjanju argumenta metoda vrne false, če je velikost sprejemnika manjša od velikosti other. Sicer prehaja po other.keys() in se ustavi pri prvem manjkajočem elementu. other.has() mora obstajati, vendar je ta algoritem ne pokliče. Pripadnost sledi semantiki SameValueZero: NaN se ujema z NaN, +0 in -0 sta enakovredna, objekti pa se primerjajo po identiteti. Lastni getterji in iteratorji lahko izvedejo kodo s stranskimi učinki.
Metoda je del ECMAScript 2025. Jezikovna specifikacija ne zagotavlja podpore v določenem brskalniku; pred uporabo v ciljnem okolju preveri typeof Set.prototype.isSupersetOf === 'function'. Različica Node, uporabljena v repozitoriju, ne dokazuje podpore v brskalnikih.
Primeri
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()));Rezultat
true false true true
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.