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

CKTIS / JavaScript

Set.prototype.has — verificar se um valor está presente

Set.prototype.has verifica se um conjunto contém um determinado valor e devolve true ou false. Não altera o conjunto; compara os valores segundo SameValueZero e os objetos segundo a sua identidade.

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

Chame Set.prototype.has como set.has(value), em que set é um conjunto Set e value é o valor a procurar. Devolve true se o valor pertencer ao conjunto, ou false caso contrário. O método não adiciona nem remove elementos.

A comparação segue a regra SameValueZero: não há conversão de tipos, pelo que 1 e "1" são diferentes. NaN corresponde a NaN, e +0 e -0 são tratados como iguais. Os objetos são comparados pela sua identidade, não pelo conteúdo: um novo objeto com propriedades idênticas não corresponde ao objeto armazenado.

Se o argumento for omitido, a procura é por undefined; não se verifica se o conjunto está vazio. O método exige um recetor com os dados internos de um conjunto Set. Chamá-lo com um objeto normal ou um array como this provoca um TypeError.

No exemplo, item é a mesma referência que foi armazenada no conjunto, enquanto { id: 1 } cria um objeto diferente. Assim, os dois últimos resultados são, respetivamente, true e false.

Exemplos

const item = { id: 1 };
const values = new Set([1, NaN, -0, item]);

console.log(values.has(1));
console.log(values.has("1"));
console.log(values.has(NaN));
console.log(values.has(+0));
console.log(values.has(item));
console.log(values.has({ id: 1 }));

Resultado

true
false
true
true
true
false

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