aboutsummaryrefslogtreecommitdiff
path: root/files/pt-br/web/javascript/reference/global_objects/set/has/index.html
blob: 1a3f5d68c8078392752743a427cad98572a05e63 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
---
title: Set.prototype.has()
slug: Web/JavaScript/Reference/Global_Objects/Set/has
translation_of: Web/JavaScript/Reference/Global_Objects/Set/has
---
<div>{{JSRef}}</div>

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

<div>{{EmbedInteractiveExample("pages/js/set-prototype-has.html")}}</div>



<h2 id="Sintaxe">Sintaxe</h2>

<pre class="syntaxbox"><em>mySet</em>.has(<em>valor</em>);</pre>

<h3 id="Parâmetros">Parâmetros</h3>

<dl>
 <dt><code>valor</code></dt>
 <dd>O valor para testar a existência no objeto <code>Set</code>.</dd>
</dl>

<h3 id="Valor_de_retorno">Valor de retorno</h3>

<p>Retorna <code>true</code> se um elemento com o valor especificado existe no objeto <code>Set</code><code>false</code> caso contrário.</p>

<div class="blockIndicator note">
<p><strong>Nota: </strong>Tecnicamente falando, <code>has()</code> usa o algorítimo <code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Equality_comparisons_and_sameness#Same-value-zero_equality">sameValueZero</a></code> para determinar quando o elemento dado é encontrado.</p>
</div>

<h2 id="Exemplos">Exemplos</h2>

<h3 id="Usando_o_método_has">Usando o método <code>has</code></h3>

<pre class="brush: 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
</pre>

<h2 id="Especificações">Especificações</h2>

<table class="standard-table">
 <tbody>
  <tr>
   <th scope="col">Especificação</th>
   <th scope="col">Status</th>
   <th scope="col">Comentário</th>
  </tr>
  <tr>
   <td>{{SpecName('ES2015', '#sec-set.prototype.has', 'Set.prototype.has')}}</td>
   <td>{{Spec2('ES2015')}}</td>
   <td>Definição inicial.</td>
  </tr>
  <tr>
   <td>{{SpecName('ESDraft', '#sec-set.prototype.has', 'Set.prototype.has')}}</td>
   <td>{{Spec2('ESDraft')}}</td>
   <td></td>
  </tr>
 </tbody>
</table>

<h2 id="Compatibilidade_de_navegadores">Compatibilidade de navegadores</h2>



<p>{{Compat("javascript.builtins.Set.has")}}</p>

<h2 id="Veja_também">Veja também:</h2>

<ul>
 <li>{{jsxref("Set")}}</li>
 <li>{{jsxref("Set.prototype.add()")}}</li>
 <li>{{jsxref("Set.prototype.delete()")}}</li>
</ul>