MDN’s new design is in Beta! A sneak peek: https://blog.mozilla.org/opendesign/mdns-new-design-beta/

Storage.getItem()

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 = storage.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
Web Storage (Second edition)
The definition of 'getItem()' in that specification.
Recommendation  

Compatibilidade

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: carol-caires
 Última atualização por: carol-caires,