Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Set.prototype.symmetricDifference — differenza simmetrica tra insiemi

Se gli elementi in ingresso rimangono invariati durante la chiamata, symmetricDifference() restituisce un nuovo Set con i valori presenti in uno solo dei due insiemi. Il metodo di per sé non modifica 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.symmetricDifference(other)

Se gli elementi in ingresso rimangono invariati durante la chiamata, a.symmetricDifference(b) restituisce un nuovo Set contenente i valori appartenenti ad a oppure a b, ma non a entrambi. Per un argomento simile a un insieme, i valori forniti da keys() ne costituiscono gli elementi. A differenza della differenza in una sola direzione, la differenza simmetrica include gli elementi esclusivi di ciascuno dei due insiemi. Il metodo di per sé non modifica gli insiemi di input.

Il ricevitore this deve essere un vero oggetto Set. L’argomento other può essere un oggetto simile a un insieme: deve esporre una proprietà size e i metodi invocabili has e keys. La conversione di size in un numero non deve produrre NaN e il risultato non deve essere negativo dopo il troncamento verso zero. Un valore di size pari a -0.5 è quindi accettato se il resto dell’interfaccia è valido. L’algoritmo verifica questa interfaccia, ma recupera i valori tramite keys(), non tramite has(). Una Map soddisfa i requisiti: in questo contesto le sue chiavi fungono da elementi. Un normale array non soddisfa questa interfaccia. Gli accessor e i metodi personalizzati dell’argomento possono avere effetti collaterali.

L’algoritmo copia i dati del ricevitore prima di far avanzare per la prima volta l’iteratore dell’argomento. Per ogni chiave prodotta, però, verifica se è presente nel ricevitore in quel momento, non nella copia. Se l’iteratore modifica il contenuto del ricevitore, il risultato non coincide necessariamente con la differenza simmetrica tra le chiavi prodotte e il contenuto iniziale o finale del ricevitore.

Con input stabili, il risultato mantiene prima l’ordine dei valori presenti solo nel ricevitore, poi quello dei valori presenti solo in other, secondo quanto fornito da keys(). Il confronto segue SameValueZero: NaN corrisponde a NaN, +0 e -0 sono equivalenti e gli oggetti vengono confrontati per identità, non per contenuto.

Il metodo fa parte di ECMAScript 2025 e non è una Web API separata. La specifica citata non fornisce una tabella di compatibilità dei browser; prima della distribuzione, verifica typeof Set.prototype.symmetricDifference === "function" nell’ambiente di destinazione. Node 24 nel repository non dimostra il supporto nei browser.

Esempi

const a = new Set([1, 2, 3]);
const b = new Set([3, 4, 2, 5]);
const result = a.symmetricDifference(b);

console.log(JSON.stringify([...result]));
console.log(JSON.stringify([...a]));
console.log(JSON.stringify([...b]));

Risultato

[1,4,5]
[1,2,3]
[3,4,2,5]

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