Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Set.prototype.isDisjointFrom — verificare se gli insiemi sono disgiunti

Set.prototype.isDisjointFrom verifica se un insieme non ha elementi in comune con un altro insieme o con un oggetto compatibile con il protocollo degli insiemi. Restituisce un valore booleano invece di creare un nuovo insieme.

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

set.isDisjointFrom(other) restituisce true quando gli insiemi non hanno elementi in comune e false quando ne trova almeno uno. Per gli oggetti Set ordinari, un insieme vuoto è disgiunto da qualsiasi insieme, compreso un altro insieme vuoto. Il metodo non crea un insieme risultato e non modifica direttamente i suoi operandi.

Il ricevitore set deve essere un vero oggetto Set; non basta fornire metodi simili. L’argomento other può essere compatibile con il protocollo degli insiemi: deve esporre un size valido e i metodi invocabili has e keys. Sono adatti un Set o una Map; nel caso di una Map, vengono controllate le chiavi. Essere iterabile non è sufficiente: un normale array non è un argomento valido; usa invece new Set(array).

Per gli insiemi ordinari, il confronto segue la regola SameValueZero: NaN corrisponde a NaN e +0 a -0; gli oggetti vengono confrontati per identità, non per contenuto. Il metodo confronta il numero di elementi di set calcolato internamente con la dimensione ricavata da other.size; non legge la proprietà pubblica set.size. Se quel numero è minore o uguale alla dimensione di other, il metodo scorre set e chiama other.has; altrimenti ottiene gli elementi tramite other.keys. Si interrompe quando trova un elemento in comune. Getter o metodi personalizzati di other possono avere effetti collaterali o generare eccezioni, quindi evita di modificare gli insiemi durante il controllo.

Il metodo fa parte di ECMAScript 2025, non delle Web APIs. La specifica del linguaggio non conferma il supporto in una particolare versione del browser. Prima di usarlo nell’ambiente di destinazione, controlla typeof Set.prototype.isDisjointFrom === "function"; la presenza di Node 24 in un repository non dimostra il supporto nei browser.

Esempi

const selected = new Set([2, 4]);
const available = new Set([1, 3]);
const reserved = new Set([4, 6]);

console.log(selected.isDisjointFrom(available));
console.log(selected.isDisjointFrom(reserved));
console.log(selected.isDisjointFrom(new Set()));

Risultato

true
false
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