Esta página foi traduzida do inglês pela comunidade. Saiba mais e junte-se à comunidade MDN Web Docs.

View in English Always switch to English

localStorage.getItem()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨julho de 2015⁩.

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.

js
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

Specification
HTML
# dom-storage-getitem-dev

Compatibilidade com navegadores

Veja também

Usando a API Web Storage