CKTIS / JavaScript
Set.prototype.union — unione di insiemi
Set.prototype.union(other) crea un nuovo Set con i valori di entrambi gli insiemi, senza duplicati. Mantiene l’ordine dell’insieme a sinistra, poi aggiunge i nuovi valori di other. L’argomento deve rispettare il protocollo degli oggetti simili a insiemi, non basta che sia iterabile.
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.union(other)Set.prototype.union(other) calcola un’unione: restituisce un nuovo Set contenente i valori presenti in almeno uno degli input. Mantiene prima l’ordine di inserimento del ricevente, poi aggiunge i valori mancanti nell’ordine restituito da other.keys(). L’algoritmo in sé non modifica gli insiemi di input; tuttavia, getter e metodi personalizzati di other possono avere effetti collaterali.
Il ricevente deve essere un vero oggetto Set con dati interni dell’insieme. other può essere un oggetto simile a un insieme: deve fornire un size valido e metodi has e keys invocabili; keys() deve restituire un iteratore. union verifica has, ma non lo chiama. Una Map rispetta questo protocollo: vengono usate le sue chiavi. Essere iterabile non basta: un normale array non è un argomento valido; usa new Set(array).
I duplicati sono individuati secondo la semantica SameValueZero: i valori NaN sono considerati uguali, così come +0 e -0; gli oggetti sono confrontati per identità, non per contenuto. Il risultato è superficiale: contiene gli stessi riferimenti agli oggetti. È un normale Set, anche quando il ricevente è un’istanza di una sottoclasse.
Il metodo fa parte di ECMAScript 2025, non di una Web API. La specifica del linguaggio non attesta il supporto in uno specifico browser; la presenza di Node 24 in un repository non dimostra neppure il supporto nei browser. Prima di usarlo, verifica typeof Set.prototype.union === "function" nell’ambiente di destinazione e, se necessario, fornisci un’alternativa conforme.
Esempi
const left = new Set([3, 1]);
const right = new Set([1, 2]);
const result = left.union(right);
console.log(JSON.stringify([...result]));
console.log(JSON.stringify([...left]));
console.log(JSON.stringify([...right]));
console.log(result !== left && result !== right);Risultato
[3,1,2] [3,1] [1,2] 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.