CKTIS / JavaScript
Set.prototype.intersection — elementi comuni tra insiemi
Il metodo intersection(other) restituisce un nuovo Set contenente i valori presenti in entrambe le raccolte. L’ordine del risultato dipende dalle dimensioni degli operandi; other può anche essere un oggetto con un’interfaccia simile a Set.
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.intersection(other)set.intersection(other) calcola un’intersezione: restituisce un nuovo Set contenente i valori presenti in entrambe le raccolte. Con insiemi ordinari, non modifica nessuno dei due input. Il metodo fa parte di ECMAScript 2025, non di un’API del browser. La specifica da sola non dimostra il supporto in un browser specifico; prima dell’uso controlla typeof Set.prototype.intersection === "function". La presenza di Node 24 in un repository non dimostra il supporto nei browser.
Il ricevitore set 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. Anche un Map è adatto; le sue chiavi vengono trattate come elementi. Essere iterabile non basta: un normale array non implementa questa interfaccia. Un ricevitore non valido causa un TypeError.
Con insiemi ordinari, il metodo attraversa l’insieme più piccolo e ne mantiene l’ordine di inserimento. Se le dimensioni sono uguali, usa l’ordine di set. Di conseguenza, a.intersection(b) e b.intersection(a) possono contenere gli stessi elementi in ordini diversi. Con insiemi ordinari, la verifica dell’appartenenza segue la semantica SameValueZero: NaN corrisponde a NaN, +0 e -0 sono equivalenti e gli oggetti devono avere la stessa identità. Quando la dimensione del ricevitore è minore o uguale a quella indicata da other, il metodo verifica l’appartenenza chiamando other.has. Un metodo has personalizzato non è tenuto a seguire la semantica SameValueZero e può, ad esempio, considerare equivalenti oggetti distinti.
Nell’esempio, right è più piccolo, quindi l’ordine del risultato è [3,2], mentre le dimensioni degli input restano invariate. Getter personalizzati e metodi has e keys di other possono eseguire codice, modificare dati o generare eccezioni; in tal caso, non presumere che l’operazione sia priva di effetti collaterali.
Esempi
const left = new Set([1, 2, 3, 4]);
const right = new Set([3, 2]);
const common = left.intersection(right);
console.log(JSON.stringify([...common]));
console.log(left.size, right.size);Risultato
[3,2] 4 2
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.