A API de armazenamento na web (Web Storage) fornece mecanismos para que os navegadores possam armazenar dados através de chave/valor de uma forma mais eficiente que os cookies.

Armazenamento na Web conceitos e formas de uso

A API de Web Storage fornece duas maneiras de armazenar dados:

• sessionStorage mantém as informações armazenadas por origem e permanece disponível enquanto há uma sessão aberta no navegador (mesmo a página sendo recarregada). Caso o browser seja fechado a sessão será limpa e as informações serão perdidas.
• localStorage mesmo que o navegador seja fechado, os dados permanecem armazenados.

Esses mecanismos estão disponíveis a partir das seguintes propriedadesWindow.sessionStorage eWindow.localStorage (para um maior suporte, o objetoWindow implementa os objetosWindow.LocalStorage eWindow.SessionStorage) — ao invocar uma dessas propriedades, é criada uma instância do objetoStorage, que fornece métodos para inserir, recuperar e remover os dados. Sempre será utilizado um objeto diferente para cada origem desessionStorage elocalStorage, dessa forma o controle de ambos é realizado de forma separada.

Interfaces de Armazenamento na Web

Storage

Permite que você insira, recupere e remova dados de um domínio no storage(session ou local).

Window

A API de Web Storage estende o objetoWindow com duas novas propriedades —Window.sessionStorage eWindow.localStorage — fornecendo acesso à sessão do domínio atual e local para o objetoStorage respectivamente.

StorageEvent

Um evento de storage é chamado em um objeto window do documento quando ocorre uma mudança no storage.

Exemplos

Para desmonstrar o uso de web storage, nós criamos um exemplo simples, chamadoWeb Storage Demo. A página da demolanding page oferece funcionalidades que permitem alterar a cor, fonte e imagem que é exibida na página. Quando você escolhe uma opção diferente, a página será atualizada imediatamente. Além disso, sua escolha foi armazenada emlocalStorage, para que quando você feche o navegador e abra novamente para acessar a página, suas escolhas sejam lembradas.

Nós também fornecemos umevent output page — para quando você abrir a página em outra aba, as informações sejam atualizadas através da chamada de umStorageEvent.

Especificações

Compatibilidade com navegadores

api.Window.localStorage

api.Window.sessionStorage

Navegação privada /modo de navegação anônima

Boa parte dos navegadores atuais suportam a opção de privacidade chamada modo de "Navegação privada ou anônima", que basicamente torna a sessão de navegação privada e não deixa rastros depois que o navegador é fechado. Este modo é incompatível com armazenamento na Web por razões óbvias. Os fabricantes de navegadores estão experimentando com diferentes cenários como lidar com essa incompatibilidade.

A maioria dos navegadores optaram por uma estratégia onde as APIs de armazenamento ainda estão disponíveis e, aparentemente, funcional, com a grande diferença de que todos os dados armazenados é apagado depois que o navegador é fechado. Para estes navegadores ainda existem diferentes interpretações sobre o que deve ser feito com os dados existentes armazenados (a partir de uma sessão de navegação regular). E quanto a leitura dos dados se o navegador estiver no modo privado? Há alguns navegadores, principalmente Safari, que optaram por uma solução em que o armazenamento está disponível, mas está vazio e tem uma quota de 0 bytes atribuídos, tornando impossível o armazenamento de dados.

Os desenvolvedores devem estar cientes e considerar as diferentes formas de implementações ao desenvolverem sites dependendo das APIs Web Storage. Para mais informações, leia nestepost escrito no blog do WHATWG que lida especificamente com este tópico.

Veja também

Usando a API Web Storage