CKTIS / JavaScript
Set.prototype.isSupersetOf — provjera nadskupa
Metoda isSupersetOf() provjerava sadrži li Set svaki element druge kolekcije nalik skupu. Vraća logičku vrijednost; uvjet ispunjavaju i jednaki skupovi, pa ovo nije provjera pravog nadskupa.
Verzija: 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) vraća true kada set sadrži svaki element skupa other, a inače vraća false. Uvjet ispunjavaju i jednaki skupovi, a svaki je skup nadskup praznog Set. Metoda sama ne mijenja skupove.
Primatelj set mora biti stvarni objekt Set; samo pružanje sličnih metoda nije dovoljno. Argument other može biti objekt nalik skupu: ima svojstvo size te metode has() i keys() koje se mogu pozvati. Metoda pretvara size u broj, odbacuje NaN, skraćuje konačne vrijednosti na cijeli broj prema nuli, a zatim odbacuje negativan rezultat. Primjerice, znakovni niz "1" prihvaća se kao veličina 1. I Set i Map ispunjavaju ove zahtjeve — za Map se koriste njezini ključevi. Običan niz ne ispunjava ovaj ugovor; upotrijebi new Set(array).
Nakon provjere argumenta metoda vraća false ako je veličina primatelja manja od veličine skupa other. U suprotnom prolazi kroz other.keys() i zaustavlja se na prvom elementu koji nedostaje. other.has() mora postojati, ali je ovaj algoritam ne poziva. Pripadnost slijedi semantiku SameValueZero: NaN odgovara vrijednosti NaN, +0 i -0 su ekvivalentni, a objekti se uspoređuju prema identitetu. Prilagođeni getteri i iteratori mogu izvršavati kod sa sporednim učincima.
Metoda je dio ECMAScript 2025. Jezična specifikacija ne jamči podršku u određenom pregledniku; prije upotrebe u ciljnom okruženju provjeri typeof Set.prototype.isSupersetOf === 'function'. Verzija Nodea koja se koristi u repozitoriju ne dokazuje podršku u preglednicima.
Primjeri
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
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.