Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Set.prototype.isSubsetOf — verificare i sottoinsiemi

Set.prototype.isSubsetOf verifica se ogni elemento di un insieme è presente in un altro insieme o in un oggetto simile a un insieme. Restituisce un booleano; anche gli insiemi uguali soddisfano questa condizione.

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.isSubsetOf(other)

set.isSubsetOf(other) restituisce true quando ogni elemento di set appartiene a other; altrimenti restituisce false. Non verifica se si tratta di un sottoinsieme proprio: un insieme è sottoinsieme di sé stesso. L’insieme vuoto è sottoinsieme di ogni insieme valido. Il metodo non modifica gli insiemi.

Il ricevitore set deve essere un vero oggetto Set. L’argomento other può essere un Set o un oggetto con una proprietà size e metodi has e keys invocabili, come una Map, di cui vengono controllate le chiavi. Essere iterabile non basta: un array non è un argomento valido. Il metodo richiede che keys sia invocabile, anche se non la chiama.

Dopo aver convalidato l’argomento, il metodo restituisce false se il numero di elementi memorizzati internamente in set supera la dimensione di other. Per questo confronto non legge la proprietà set.size. Altrimenti controlla gli elementi tramite other.has e si ferma al primo elemento mancante. Negli insiemi ordinari, gli oggetti vengono confrontati per identità, non per contenuto. Getter e metodi personalizzati dell’argomento possono causare effetti collaterali o generare eccezioni.

Il metodo fa parte di ECMAScript 2025, non delle Web APIs. La specifica non conferma il supporto in uno specifico browser; nemmeno la presenza di Node 24 in un repository lo dimostra. Controlla typeof Set.prototype.isSubsetOf === "function" nell’ambiente di destinazione.

Esempi

const required = new Set(["read"]);
const granted = new Set(["read", "write"]);

console.log(required.isSubsetOf(granted));
console.log(granted.isSubsetOf(required));
console.log(required.isSubsetOf(required));
console.log(new Set().isSubsetOf(granted));

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