Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti