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

CKTIS / JavaScript

Set.prototype.add — adicionar um valor a um conjunto

Set.prototype.add(value) adiciona um único valor a um conjunto, caso ainda não esteja presente. Altera o Set existente e devolve esse mesmo objeto, permitindo encadear chamadas.

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.add(value)

set.add(value) adiciona um valor a um objeto Set existente. Se o valor já estiver presente, o conjunto não se altera. O método devolve sempre o mesmo conjunto, e não um valor booleano que indique se ocorreu uma inserção; por isso, é possível escrever set.add(a).add(b). Um valor novo fica no fim da ordem de iteração; voltar a adicionar um valor existente não altera a sua posição.

A unicidade segue a comparação SameValueZero: NaN é duplicado de NaN, e -0 e +0 representam o mesmo elemento; o zero é armazenado como +0. Os objetos são comparados pela identidade, não pelo conteúdo. Assim, dois objetos {} criados separadamente são elementos distintos, mas voltar a adicionar a mesma referência não aumenta size.

add não expande arrays nem outros iteráveis: set.add([1, 2]) adiciona um único array. Uma chamada sem argumentos adiciona undefined. O método requer um recetor com dados internos de Set; Set.prototype.add.call({}, 1) lança um TypeError.

Exemplos

const values = new Set();
const returned = values.add("blue").add("green").add("blue");
console.log(returned === values);
console.log(values.size);
console.log([...values].join(","));
values.add(NaN).add(NaN).add(-0).add(+0);
console.log(values.size);

Resultado

true
2
blue,green
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