Esta página foi traduzida do inglês pela comunidade. Saiba mais e junte-se à comunidade MDN Web Docs.

View in English Always switch to English

Set.prototype.has()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨julho de 2015⁩.

O método has() retorna um valor booleano indicando se um elemento com o valor especificado existe em um objecto Set ou não.

Experimente

const set1 = new Set([1, 2, 3, 4, 5]);

console.log(set1.has(1));
// Expected output: true

console.log(set1.has(5));
// Expected output: true

console.log(set1.has(6));
// Expected output: false

Sintaxe

mySet.has(valor);

Parâmetros

valor

O valor para testar a existência no objeto Set.

Valor de retorno

Retorna true se um elemento com o valor especificado existe no objeto Set; false caso contrário.

**Nota:**Tecnicamente falando, has() usa o algorítimo sameValueZero para determinar quando o elemento dado é encontrado.

Exemplos

Usando o método has

js
var mySet = new Set();
mySet.add("foo");

mySet.has("foo"); // retorna true
mySet.has("bar"); // retorna false

var set1 = new Set();
var obj1 = { key1: 1 };
set1.add(obj1);

set1.has(obj1); // retorna true
set1.has({ key1: 1 }); // retorna false porque obj1 e {'key': 1} fazem referência a objetos diferentes.
set1.add({ key1: 1 }); // agora set1 contém 2 registros

Especificações

Specification
ECMAScript® 2026 Language Specification
# sec-set.prototype.has

Compatibilidade com navegadores

Veja também