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 a página (aba ou janela) é fechada.
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 |
Navegadores compatíveis
| 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.