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

CKTIS / JavaScript

Set.prototype.union — união de conjuntos

Set.prototype.union(other) cria um novo Set com os valores dos dois conjuntos, sem duplicados. Mantém a ordem do conjunto à esquerda e, em seguida, acrescenta os novos valores de other. O argumento tem de respeitar o protocolo de objetos do tipo conjunto; não basta ser iterável.

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.union(other)

Set.prototype.union(other) calcula uma união: devolve um novo Set com os valores presentes em pelo menos uma das entradas. Primeiro, mantém a ordem de inserção do recetor; depois, acrescenta os valores em falta pela ordem devolvida por other.keys(). O algoritmo, por si só, não modifica os conjuntos de entrada; ainda assim, getters e métodos personalizados de other podem ter efeitos secundários.

O recetor tem de ser um objeto Set genuíno com dados internos de conjunto. other pode ser um objeto do tipo conjunto: tem de fornecer um size válido e métodos has e keys invocáveis; keys() tem de devolver um iterador. union verifica has, mas não o invoca. Uma Map respeita este protocolo — são usadas as respetivas chaves. Ser iterável não é suficiente: um array normal não é um argumento válido; utiliza new Set(array).

Os duplicados são determinados segundo a semântica SameValueZero: os valores NaN são considerados iguais, tal como +0 e -0; os objetos são comparados pela identidade, não pelo conteúdo. O resultado é superficial: mantém as mesmas referências para os objetos. É um Set normal, mesmo quando o recetor é uma instância de uma subclasse.

O método faz parte de ECMAScript 2025, não de uma Web API. A especificação da linguagem não confirma o suporte num navegador específico; a presença de Node 24 num repositório também não comprova o suporte nos navegadores. Antes de o utilizar, verifica typeof Set.prototype.union === "function" no ambiente de destino e fornece uma alternativa conforme, se necessário.

Exemplos

const left = new Set([3, 1]);
const right = new Set([1, 2]);
const result = left.union(right);

console.log(JSON.stringify([...result]));
console.log(JSON.stringify([...left]));
console.log(JSON.stringify([...right]));
console.log(result !== left && result !== right);

Resultado

[3,1,2]
[3,1]
[1,2]
true

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