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 July 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 Standard
# dom-storage-getitem-dev

Compatibilidade com navegadores

BCD tables only load in the browser

Veja também