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

CKTIS / JavaScript

Set.prototype.symmetricDifference — diferencia simétrica de conjuntos

Si los elementos de entrada no cambian durante la llamada, symmetricDifference() devuelve un nuevo Set con los valores presentes en exactamente uno de los dos conjuntos. El método en sí no modifica los conjuntos de entrada.

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

Si los elementos de entrada no cambian durante la llamada, a.symmetricDifference(b) devuelve un nuevo Set con los valores que pertenecen a a o a b, pero no a ambos. En un argumento similar a un conjunto, los valores que proporciona keys() son sus elementos. A diferencia de la diferencia en un solo sentido, la diferencia simétrica incluye los elementos exclusivos de cada lado. El método en sí no modifica los conjuntos de entrada.

El receptor this debe ser un objeto Set real. El argumento other puede ser un objeto similar a un conjunto: debe exponer una propiedad size, además de métodos has y keys invocables. La conversión de size a número no debe dar NaN, y el resultado no debe ser negativo tras el truncamiento hacia cero. Por tanto, se acepta un size de -0.5 si se cumplen los demás requisitos de la interfaz. El algoritmo valida esta interfaz, pero obtiene los valores mediante keys(), no mediante has(). Una Map cumple los requisitos y sus claves actúan aquí como elementos; un array normal no satisface esta interfaz. Los accesores y métodos personalizados del argumento pueden tener efectos secundarios.

El algoritmo copia los datos del receptor antes de avanzar por primera vez el iterador del argumento, pero comprueba si cada clave que este produce está en el receptor en ese momento, no en la copia. Si el iterador modifica el contenido del receptor, el resultado no tiene por qué coincidir con la diferencia simétrica entre las claves producidas y el contenido inicial o final del receptor.

Con entradas estables, el resultado conserva primero el orden de los valores exclusivos del receptor y, después, el de los exclusivos de other, según los proporciona keys(). La comparación sigue SameValueZero: NaN coincide con NaN, +0 y -0 son equivalentes, y los objetos se comparan por identidad, no por contenido.

El método forma parte de ECMAScript 2025, no es una Web API independiente. La especificación citada no incluye una tabla de compatibilidad de navegadores; antes de implementarlo, comprueba typeof Set.prototype.symmetricDifference === "function" en el entorno de destino. La presencia de Node 24 en el repositorio no demuestra que haya compatibilidad con navegadores.

Ejemplos

const a = new Set([1, 2, 3]);
const b = new Set([3, 4, 2, 5]);
const result = a.symmetricDifference(b);

console.log(JSON.stringify([...result]));
console.log(JSON.stringify([...a]));
console.log(JSON.stringify([...b]));

Resultado

[1,4,5]
[1,2,3]
[3,4,2,5]

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