CKTIS / JavaScript
Set.prototype.difference — diferença de conjuntos
O método difference() devolve um novo Set com os elementos do conjunto recetor que não estão presentes no outro conjunto. Mantém a respetiva ordem e não modifica, por si só, os conjuntos de entrada.
Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxe
set.difference(other)Set.prototype.difference calcula a diferença de conjuntos: a.difference(b) contém os elementos de a que não estão presentes em b. A ordem dos operandos é importante — não se trata de uma diferença simétrica. O resultado é um novo Set que mantém a ordem de inserção dos elementos restantes de a; a operação não modifica, por si só, os conjuntos de entrada.
O recetor this tem de ser um objeto Set real. O argumento other pode ser um conjunto ou um objeto semelhante a um conjunto: tem de disponibilizar um size válido e métodos has() e keys() invocáveis. Map cumpre este protocolo, sendo comparadas as respetivas chaves. Ser iterável não é suficiente: primeiro, passe um array a new Set(...).
Para conjuntos comuns, a igualdade segue SameValueZero: NaN corresponde a NaN, +0 e -0 são equivalentes e os objetos são comparados pela identidade, não pelo conteúdo. Consoante os tamanhos, o algoritmo utiliza other.has() ou percorre other.keys(). Métodos e getters personalizados podem, assim, causar efeitos secundários; não assuma que a respetiva ordem de chamada é independente do tamanho.
O método faz parte de ECMAScript 2025, não das Web APIs. Ao implementar, verifique typeof Set.prototype.difference === "function" no ambiente de destino. A especificação não é uma tabela de compatibilidade dos browsers, e a presença de Node 24 num repositório não comprova o suporte nos browsers.
Exemplos
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]
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.