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.