blob: 9ed50459ad480b2314dcc02085a30e12ae8aa4db (
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
|
---
title: Storage.key()
slug: Web/API/Storage/key
translation_of: Web/API/Storage/key
---
<div>{{APIRef("Web Storage API")}}</div>
<p>O método <strong><code>key()</code></strong> da interface {{domxref("Storage")}}, quando passado um número n, retorna o nome da n-ésima chave no dado objeto <code>Storage</code>. A ordem das chaves é definida pelo user-agent, então não deve-se confiar nela.</p>
<h2 id="Syntax">Syntax</h2>
<pre class="syntaxbox">var <em>aKeyName</em> = <em>storage</em>.key(<em>index</em>);</pre>
<h3 id="Parâmetros">Parâmetros</h3>
<dl>
<dt><code>index</code></dt>
<dd>Um inteiro representando o número da chave que deseja obter. Esse é um índice que começa em zero.</dd>
</dl>
<h3 id="Retorno">Retorno</h3>
<p>Uma {{domxref("DOMString")}} contendo o nome da chave. Se o index não existir, retornará <code>null</code>.</p>
<h2 id="Exemplos">Exemplos</h2>
<p>A função a seguir itera sobre as chaves do armazenamento local:</p>
<pre class="brush: js">function forEachKey(callback) {
for (var i = 0; i < localStorage.length; i++) {
callback(localStorage.key(i));
}
}</pre>
<p>A função a seguir itera sobre as chaves do armazenamento local e obtém o valor de cada chave:</p>
<pre class="brush: js">for(var i =0; i < localStorage.length; i++){
console.log(localStorage.getItem(localStorage.key(i)));
}</pre>
<div class="note">
<p><strong>Nota</strong>: Pra ver um exemplo real, consulte nossa <a href="https://mdn.github.io/dom-examples/web-storage/">Demonstração de armazenamento na Web</a>.</p>
</div>
<h2 id="Especificações">Especificações</h2>
<table class="standard-table">
<tbody>
<tr>
<th scope="col">Especificação</th>
<th scope="col">Estado</th>
<th scope="col">Comentário</th>
</tr>
<tr>
<td>{{SpecName('HTML WHATWG', 'webstorage.html#dom-storage-key', 'Storage.key')}}</td>
<td>{{Spec2('HTML WHATWG')}}</td>
<td></td>
</tr>
</tbody>
</table>
<h2 id="Compatibilidade_com_navegadores">Compatibilidade com navegadores</h2>
<p>{{Compat("api.Storage.key")}}</p>
<h2 id="Veja_também">Veja também</h2>
<ul>
<li><a href="/en-US/docs/Web/API/Web_Storage_API/Using_the_Web_Storage_API">Using the Web Storage API</a></li>
</ul>
|
