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

CKTIS / JavaScript

Set — uma coleção de valores únicos

Set armazena cada valor distinto apenas uma vez e permite iterar pela ordem de inserção. Utilize-o para remover duplicados e verificar se um valor está presente sem percorrer manualmente um array.

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

new Set()
new Set(iterable)
set.add(value)
set.has(value)
set.delete(value)
set.clear()
set.size

Set é uma coleção incorporada de valores, não de pares chave-valor. Crie uma com new Set() ou new Set(iterable), por exemplo, a partir de um array. O construtor exige new. Os duplicados não criam elementos adicionais.

add(value) adiciona um valor e devolve o mesmo conjunto, permitindo encadear chamadas. has(value) indica se um valor está presente, enquanto delete(value) devolve true se um elemento tiver sido removido ou false se não estiver presente. clear() remove todos os elementos. Consulte o número de elementos através da propriedade size, não de length nem de size().

A unicidade segue a regra SameValueZero: NaN é equivalente a NaN, e +0 e -0 representam o mesmo elemento. 1 e "1" continuam a ser diferentes. Os objetos são comparados pela identidade, não pelo conteúdo: dois objetos {} criados separadamente são dois elementos.

A iteração com for...of ou [...set] preserva a ordem de inserção. Adicionar novamente um valor existente não altera a sua posição; removê-lo e adicioná-lo de novo desloca-o para o fim. Set não permite aceder aos elementos através de um índice numérico.

Esta entrada abrange a API principal, sem os métodos mais recentes para operações entre conjuntos. A especificação da linguagem não é uma tabela de compatibilidade dos navegadores: verifique a disponibilidade no ambiente de destino; Node 24 não comprova o suporte nos navegadores.

Exemplos

const values = new Set([3, 1, 3, 2]);
values.add(1);
console.log(values.size);
console.log(values.has(2));
console.log(values.delete(1));
values.add(1);
console.log([...values].join(','));

Resultado

3
true
true
3,2,1

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