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

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.

Fuentes