Window.localStorage

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
Web Storage (Second edition)
The definition of 'localStorage' in that specification.
Recommendation  

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,