Esta tradução está incompleta. Por favor, ajude a traduzir este artigo.

Passar o nome da chave para o método getItem() da interface Storage retornará o seu valor.

Sintaxe

var aValue = localStorage.getItem(keyName);

Parâmetros

keyName
Um DOMString contendo o nome da chave cujo valor você quer obter.

Retorno

Um DOMString contendo o valor da chave. Se a chave não existe, é retornado null.

Exemplo

A função seguinte recupera três itens armazenados no local storage e usa-os para definir estilos customizados em uma página.

function setStyles() {
  var currentColor = localStorage.getItem('bgcolor');
  var currentFont = localStorage.getItem('font');
  var currentImage = localStorage.getItem('image');

  document.getElementById('bgcolor').value = currentColor;
  document.getElementById('font').value = currentFont;
  document.getElementById('image').value = currentImage;

  htmlElem.style.backgroundColor = '#' + currentColor;
  pElem.style.fontFamily = currentFont;
  imgElem.setAttribute('src', currentImage);
}

Nota: Para ver essa funcionalidade aplicada a um exemplo real, veja nossa Web Storage Demo.

Especificações

Especificação Status Comment
Unknown
The definition of 'getItem()' in that specification.
Desconhecido  

Compatibilidade

Estamos convertendo nossos dados de compatibilidade para o formato JSON. Esta tabela de compatibilidade ainda usa o formato antigo, pois ainda não convertemos os dados que ela contém. Descubra como você pode ajudar!

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
localStorage 4 3.5 8 10.50 4
sessionStorage 5 2 8 10.50 4
Feature Android Firefox Mobile (Gecko) IE Phone Opera Mobile Safari Mobile
Basic support 2.1 ? 8 11 iOS 3.2

Os níveis de compatibilidade podem variar em todos os navegadores, tanto para o localStorage quanto para o sessionStorage. Aqui temos estatísticas detalhadas dos níveis de compatibilidade para vários navegadores.

Nota: A partir da versão 5.1 do iOS, o Safari Mobile armazena os dados do localStorage na pasta do cache, sujeito a ser apagado em caso de espaço insificiente.

Veja também

Usando a API Web Storage

Etiquetas do documento e colaboradores

Colaboradores desta página: victormaestri, carol-caires
Última atualização por: victormaestri,