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

CKTIS / JavaScript

Set.prototype.symmetricDifference — diferença simétrica de conjuntos

Se os elementos de entrada se mantiverem inalterados durante a chamada, symmetricDifference() devolve um novo Set com os valores presentes em exatamente um dos dois conjuntos. O método em si não altera 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.symmetricDifference(other)

Se os elementos de entrada se mantiverem inalterados durante a chamada, a.symmetricDifference(b) devolve um novo Set com os valores que pertencem a a ou a b, mas não a ambos. Num argumento semelhante a um conjunto, os valores fornecidos por keys() são os seus elementos. Ao contrário da diferença num único sentido, a diferença simétrica inclui os elementos exclusivos de cada lado. O método em si não altera os conjuntos de entrada.

O recetor this tem de ser um objeto Set real. O argumento other pode ser um objeto semelhante a um conjunto: tem de expor uma propriedade size, bem como métodos has e keys invocáveis. A conversão de size num número não pode resultar em NaN e o resultado não pode ser negativo após o truncamento em direção a zero. Assim, um size de -0.5 é aceite se os restantes requisitos da interface forem cumpridos. O algoritmo valida esta interface, mas obtém os valores através de keys(), não de has(). Uma Map cumpre os requisitos, sendo as respetivas chaves tratadas como elementos neste contexto; um array comum não satisfaz esta interface. Os acessores e métodos personalizados do argumento podem ter efeitos secundários.

O algoritmo copia os dados do recetor antes de avançar pela primeira vez o iterador do argumento. Para cada chave produzida, verifica se esta está presente no recetor naquele momento, não na cópia. Se o iterador alterar o conteúdo do recetor, o resultado pode não corresponder à diferença simétrica entre as chaves produzidas e o conteúdo inicial ou final do recetor.

Com entradas estáveis, o resultado mantém primeiro a ordem dos valores exclusivos do recetor e, depois, a dos valores exclusivos de other, conforme fornecida por keys(). A comparação 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.

O método faz parte de ECMAScript 2025 e não é uma Web API separada. A especificação citada não fornece uma tabela de compatibilidade dos browsers; antes da implementação, verifique typeof Set.prototype.symmetricDifference === "function" no ambiente de destino. A presença de Node 24 no repositório não comprova o suporte nos browsers.

Exemplos

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]

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