Propriedade Window localStorage

Definição e uso

As propriedades localStorage e sessionStorage permitem salvar pares de chave/valor no navegador da Web.

O objeto localStorage armazena dados sem data de expiração. Os dados não são excluídos quando o navegador é fechado e estarão disponíveis no dia seguinte, na semana ou um ano depois.

A propriedade localStorage é apenas leitura.

Dica:Veja também Propriedade sessionStorage，a propriedade armazena dados de uma sessão (os dados são perdidos ao fechar o ícone de navegador).

Exemplo

Exemplo 1

Crie um par de nome="lastname" e valor="Smith" para o localStorage, e recupere o valor de "lastname" para inserir no elemento com id="result":

// Salvar
localStorage.setItem("lastname", "Smith");
// Recuperar
document.getElementById("result").innerHTML = localStorage.getItem("lastname");

Experimente você mesmo

Exemplo 2

O exemplo a seguir calcula o número de vezes que o usuário clicou no botão:

if (localStorage.clickcount) {
  localStorage.clickcount = Number(localStorage.clickcount) + 1;
} else {
  localStorage.clickcount = 1;
}
document.getElementById("result").innerHTML = "Você clicou no botão " +
localStorage.clickcount + " vez(es).";

Experimente você mesmo

Sintaxe

window.localStorage

A sintaxe para salvar dados no localStorage:

localStorage.setItem("key", "value);

A sintaxe para ler dados do localStorage:

var lastname = localStorage.getItem("key);

A sintaxe para deletar dados do localStorage:

localStorage.removeItem("key);

Detalhes técnicos

Retorno: Objeto Storage

Suporte do navegador

Os números na tabela indicam a versão do navegador que suporta completamente essa propriedade.

Propriedade Chrome IE Firefox Safari Opera
localStorage 4.0 8.0 3.5 4.0 11.5