CKTIS / JavaScript
Set.prototype.intersection — elementos comuns entre conjuntos
O método intersection(other) devolve um novo Set com os valores presentes em ambas as coleções. A ordem do resultado depende do tamanho dos operandos; other também pode ser um objeto que disponibilize uma interface semelhante à de Set.
Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxe
set.intersection(other)set.intersection(other) calcula uma interseção: devolve um novo Set com os valores presentes em ambas as coleções. Com conjuntos comuns, não altera nenhuma das entradas. O método faz parte de ECMAScript 2025, não de uma API do navegador. A especificação, por si só, não comprova o suporte num navegador específico; verifica typeof Set.prototype.intersection === "function" antes de o utilizar. A presença de Node 24 num repositório não comprova o suporte nos navegadores.
O recetor set tem de ser um objeto Set real. O argumento other pode ser um conjunto ou um objeto semelhante a um conjunto: tem de disponibilizar um size válido e métodos has e keys invocáveis. Um Map também é válido, sendo as respetivas chaves tratadas como elementos. Ser iterável não é suficiente: um array comum não implementa esta interface. Um recetor inválido provoca um TypeError.
Para conjuntos comuns, o método percorre o conjunto mais pequeno e preserva a respetiva ordem de inserção. Se tiverem o mesmo tamanho, usa a ordem de set. Assim, a.intersection(b) e b.intersection(a) podem conter os mesmos elementos em ordens diferentes. Para conjuntos comuns, o teste de pertença segue a semântica SameValueZero: NaN corresponde a NaN, +0 e -0 são equivalentes e os objetos têm de ter a mesma identidade. Quando o tamanho do recetor é inferior ou igual ao indicado por other, o método testa a pertença invocando other.has. Um método has personalizado não tem de seguir a semântica SameValueZero e pode, por exemplo, tratar objetos distintos como equivalentes.
No exemplo, right é mais pequeno, pelo que a ordem do resultado é [3,2], enquanto os tamanhos das entradas permanecem inalterados. Getters personalizados e os métodos has e keys de other podem executar código, alterar dados ou lançar exceções; nesse caso, não assumas que a operação não tem efeitos secundários.
Exemplos
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);Resultado
[3,2] 4 2
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.