CKTIS / JavaScript
Set.prototype.difference — differenza tra insiemi
Il metodo difference() restituisce un nuovo Set con gli elementi dell’insieme ricevente che non sono presenti nell’altro insieme. Ne mantiene l’ordine e non modifica direttamente gli insiemi di input.
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.difference(other)Set.prototype.difference calcola la differenza tra insiemi: a.difference(b) contiene gli elementi di a che non sono presenti in b. L’ordine degli operandi è importante: non si tratta di una differenza simmetrica. Il risultato è un nuovo Set che mantiene l’ordine di inserimento degli elementi rimanenti di a; l’operazione non modifica direttamente gli insiemi di input.
Il ricevente this deve essere un vero oggetto Set. L’argomento other può essere un insieme o un oggetto simile a un insieme: deve esporre un size valido e i metodi invocabili has() e keys(). Map soddisfa questo protocollo e vengono confrontate le sue chiavi. Essere iterabile non è sufficiente: prima occorre passare un array a new Set(...).
Per gli insiemi ordinari, l’uguaglianza segue SameValueZero: NaN corrisponde a NaN, +0 e -0 sono equivalenti e gli oggetti vengono confrontati per identità, non per contenuto. A seconda delle dimensioni, l’algoritmo usa other.has() oppure scorre other.keys(). Metodi e getter personalizzati possono quindi causare effetti collaterali; non bisogna presumere che il loro ordine di chiamata sia indipendente dalle dimensioni.
Il metodo fa parte di ECMAScript 2025, non delle Web APIs. In fase di distribuzione, verifica typeof Set.prototype.difference === "function" nell’ambiente di destinazione. La specifica non è una tabella di compatibilità dei browser e la presenza di Node 24 in un repository non dimostra il supporto nei browser.
Esempi
const available = new Set([3, 1, 2]);
const reserved = new Set([1, 4]);
const remaining = available.difference(reserved);
console.log(JSON.stringify([...remaining]));
console.log(JSON.stringify([...available]));
console.log(JSON.stringify([...reserved]));Risultato
[3,2] [3,1,2] [1,4]
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.