A propriedade localStorage permite acessar um objeto Storage local. A localStorage é similar ao sessionStorage. A única diferença é que enquanto os dados armazenados no localStorage não expiram, os dados no sessionStorage tem os seus dados limpos ao expirar a sessão da página — ou seja, quando o navegador é fechado.

Sintaxe

meuStorage = localStorage;

Valor

Objeto Storage.

Exemplo

O seguinte trecho acessa o objeto Storage local do domínio atual e adiciona um item usando o Storage.setItem().

localStorage.setItem('meuGato', 'Tom');

Nota: Por favor veja o artigo Using the Web Storage API para um exemplo completo.

Especificações

Especificação Status Comentário
Unknown
The definition of 'localStorage' in that specification.
Desconhecido  

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

Cada navegador tem o seu nível de capacidade de armazenamento para localStorage e sessionStorage. Aqui está um teste detalhado de toda a capacidade de armazenamento de vários browsers.

Nota: desde o iOS 5.1, Safari Mobile armazena os dados do localStorage em uma pasta de cache, o que está sujeito a ocasionalmente ser limpa, de acordo com o SO, se houver pouco espaço. O modo de Navegação Privada do Safari Mobile não permite escrever no localStorage de forma alguma.

Veja também

Etiquetas do documento e colaboradores

Colaboradores desta página: wwwjsw, jjmars
Última atualização por: wwwjsw,