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.