CKTIS / JavaScript
Set.prototype.isSupersetOf — verificare se è un sovrainsieme
Il metodo isSupersetOf() verifica se un Set contiene ogni elemento di un’altra raccolta simile a un insieme. Restituisce un booleano; anche gli insiemi uguali soddisfano la condizione, quindi non è un test di sovrainsieme proprio.
Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintassi
set.isSupersetOf(other)set.isSupersetOf(other) restituisce true quando set contiene ogni elemento di other, e false altrimenti. Anche gli insiemi uguali soddisfano la condizione e ogni insieme è un sovrainsieme di un Set vuoto. Il metodo non modifica direttamente gli insiemi.
Il ricevente set deve essere un vero oggetto Set; non basta fornire metodi simili. L’argomento other può essere un oggetto simile a un insieme: espone una proprietà size e metodi invocabili has() e keys(). Il metodo converte size in un numero, rifiuta NaN, tronca i valori finiti verso zero e poi rifiuta qualsiasi risultato negativo. Ad esempio, la stringa "1" è accettata come dimensione pari a 1. Sia Set sia Map soddisfano questi requisiti: per una Map vengono usate le chiavi. Un normale array non rispetta questo contratto; usa new Set(array).
Dopo aver convalidato l’argomento, il metodo restituisce false se la dimensione del ricevente è minore di quella di other. Altrimenti scorre other.keys() e si ferma al primo elemento mancante. other.has() deve esistere, ma questo algoritmo non lo chiama. L’appartenenza segue la semantica SameValueZero: NaN corrisponde a NaN, +0 e -0 sono equivalenti e gli oggetti vengono confrontati per identità. Getter e iteratori personalizzati possono eseguire codice con effetti collaterali.
Il metodo fa parte di ECMAScript 2025. La specifica del linguaggio non garantisce il supporto in uno specifico browser; prima di usarlo, verifica typeof Set.prototype.isSupersetOf === 'function' nell’ambiente di destinazione. La versione di Node usata in un repository non dimostra il supporto nei browser.
Esempi
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()));Risultato
true false true true
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.