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  

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!

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,