Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes