Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

Set.prototype.intersection — elementos comunes de conjuntos

El método intersection(other) devuelve un Set nuevo con los valores presentes en ambas colecciones. El orden del resultado depende del tamaño de los operandos; other también puede ser un objeto que ofrezca una interfaz similar a la de Set.

Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxis

set.intersection(other)

set.intersection(other) calcula una intersección: devuelve un Set nuevo con los valores presentes en ambas colecciones. Con conjuntos ordinarios, no modifica ninguna de las entradas. El método forma parte de ECMAScript 2025, no de una API del navegador. La especificación por sí sola no acredita la compatibilidad en un navegador concreto; comprueba typeof Set.prototype.intersection === "function" antes de usarlo. Que haya Node 24 en un repositorio no demuestra la compatibilidad en navegadores.

El receptor set debe ser un objeto Set real. El argumento other puede ser un conjunto o un objeto similar a un conjunto: debe ofrecer un size válido y métodos has y keys invocables. Un Map también es válido; sus claves se tratan como elementos. Ser iterable no basta: un array ordinario no implementa esta interfaz. Un receptor no válido provoca un TypeError.

Con conjuntos ordinarios, el método recorre el conjunto más pequeño y conserva su orden de inserción. Si tienen el mismo tamaño, utiliza el orden de set. Por eso, a.intersection(b) y b.intersection(a) pueden contener los mismos elementos en órdenes distintos. Con conjuntos ordinarios, la comprobación de pertenencia sigue la semántica SameValueZero: NaN coincide con NaN, +0 y -0 son equivalentes, y los objetos deben tener la misma identidad. Cuando el tamaño del receptor es menor o igual que el indicado por other, el método comprueba la pertenencia llamando a other.has. Un método has personalizado no tiene por qué seguir la semántica SameValueZero y puede, por ejemplo, tratar objetos distintos como equivalentes.

En el ejemplo, right es más pequeño, así que el orden del resultado es [3,2], mientras que los tamaños de las entradas no cambian. Los getters personalizados y los métodos has y keys de other pueden ejecutar código, modificar datos o lanzar excepciones; en ese caso, no des por sentado que la operación carece de efectos secundarios.

Ejemplos

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

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes