Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes