English | 简体中文 | 繁體中文 | Русский язык | Français | Español | Português | Deutsch | 日本語 | 한국어 | Italiano | بالعربية

Método Storage key()

Objeto Armazenamento do JavaScript

key() O método retorna o nome da chave com o índice especificado.

O método key() pertence ao objeto de armazenamento, pode serlocalStorageobjeto ousessionStorrageobjeto.

A ordem das chaves é definida pelo user-definido pelo agente, portanto, você não deve depender dele.

Sintaxe:

localStorage.key(index)
sessionStorage.key(index)
var x = localStorage.key(0);
Testar e Verificar‹/›

Compatibilidade do navegador

Os números na tabela especificam a primeira versão do navegador que suporta completamente o método key():

Método
key()43.511.549

Valor do parâmetro

ParâmetroDescrição
indexUm inteiro que representa o número da chave cujo nome deseja obter. Este é um índice começando em zero

Detalhes técnicos

Retorno:String que contém o nome da chave. SeÍndiceSe não existir, retorna null
Versão DOM:API de armazenamento de rede

Mais exemplos

A função a seguir itera sobre as chaves armazenadas localmente:

function displayItems() {
  var items = "";
  for(var i = 0; i < localStorage.length; i++) {
 items += localStorage.key(i) + "<br>";
  }
  document.getElementById("output").innerHTML = items;
}
Testar e Verificar‹/›

A função a seguir percorre as chaves armazenadas localmente e obtém os valores definidos para cada chave:

function displayItems() {
  var items = "";
  for(var i = 0; i < localStorage.length; i++) {
 items += localStorage.key(i) + : ";
 items += localStorage.getItem(localStorage.key(i)) + "<br>";
  }
  document.getElementById("output").innerHTML = items;
}
Testar e Verificar‹/›

A seguir, a função adiciona dois itens de dados ao armazenamento de sessão atual do domínio e retorna o nome do primeiro item de armazenamento de sessão:

var x = sessionStorage.key(0);
Testar e Verificar‹/›

Referências Relacionadas

Tutorial de HTML:API de Armazenamento Web

Referência: Janela (Window)Propriedade window.localStorage

Referência: Janela (Window)Propriedade window.sessionStorage

Objeto Armazenamento do JavaScript