CKTIS / JavaScript
Set.prototype.difference — diferencia de conjuntos
El método difference() devuelve un nuevo Set con los elementos del conjunto receptor que no están en el otro conjunto. Conserva su orden y no modifica por sí mismo 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.difference(other)Set.prototype.difference calcula la diferencia de conjuntos: a.difference(b) contiene los elementos de a que no están en b. El orden de los operandos importa: no es una diferencia simétrica. El resultado es un nuevo Set que conserva el orden de inserción de los elementos restantes de a; la operación no modifica por sí misma los conjuntos de entrada.
El receptor this debe ser un objeto Set real. El argumento other puede ser un conjunto o un objeto similar a un conjunto: debe proporcionar un size válido y métodos has() y keys() invocables. Map cumple este protocolo y se comparan sus claves. Ser iterable no basta: primero hay que pasar el array a new Set(...).
En los conjuntos ordinarios, la igualdad sigue SameValueZero: NaN coincide con NaN, +0 y -0 son equivalentes, y los objetos se comparan por identidad, no por contenido. Según los tamaños, el algoritmo usa other.has() o recorre other.keys(). Por tanto, los métodos y getters personalizados pueden causar efectos secundarios; no hay que suponer que su orden de llamada sea independiente del tamaño.
El método forma parte de ECMAScript 2025, no de las Web APIs. Al implementarlo, comprueba typeof Set.prototype.difference === "function" en el entorno de destino. La especificación no es una tabla de compatibilidad de navegadores, y que Node 24 esté presente en un repositorio no demuestra que haya compatibilidad con navegadores.
Ejemplos
const available = new Set([3, 1, 2]);
const reserved = new Set([1, 4]);
const remaining = available.difference(reserved);
console.log(JSON.stringify([...remaining]));
console.log(JSON.stringify([...available]));
console.log(JSON.stringify([...reserved]));Resultado
[3,2] [3,1,2] [1,4]
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.