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

CKTIS / JavaScript

Set.prototype.union — unión de conjuntos

Set.prototype.union(other) crea un nuevo Set con los valores de ambos conjuntos, sin duplicados. Conserva el orden del conjunto de la izquierda y después añade los valores nuevos de other. El argumento debe cumplir el protocolo de los objetos similares a conjuntos, no basta con que sea iterable.

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.union(other)

Set.prototype.union(other) calcula una unión: devuelve un nuevo Set con los valores presentes en al menos una de las entradas. Primero conserva el orden de inserción del receptor y después añade los valores que faltan en el orden devuelto por other.keys(). El algoritmo en sí no modifica los conjuntos de entrada; aun así, los getters y métodos personalizados de other pueden tener efectos secundarios.

El receptor debe ser un objeto Set auténtico con datos internos de conjunto. other puede ser un objeto similar a un conjunto: debe proporcionar un size válido y métodos has y keys invocables; keys() debe devolver un iterador. union comprueba has, pero no lo invoca. Una Map cumple este protocolo: se usan sus claves. Ser iterable no basta: un array normal no es un argumento válido; usa new Set(array).

Los duplicados se determinan según la semántica SameValueZero: los valores NaN se consideran iguales, al igual que +0 y -0; los objetos se comparan por identidad, no por contenido. El resultado es superficial: conserva las mismas referencias a objetos. Es un Set normal, incluso si el receptor es una instancia de una subclase.

El método forma parte de ECMAScript 2025, no de una Web API. La especificación del lenguaje no confirma que sea compatible con un navegador concreto; que un repositorio incluya Node 24 tampoco demuestra la compatibilidad con navegadores. Antes de usarlo, comprueba typeof Set.prototype.union === "function" en el entorno de destino y proporciona una alternativa conforme si hace falta.

Ejemplos

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);

Resultado

[3,1,2]
[3,1]
[1,2]
true

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