Resumo
DOM Storage é o nome dado ao conjunto de características de armazenamento relacionadas (storage-related features) inicialmente apresentadas na especificação Web Applications 1.0, e agora dividida em sua própria especificação W3C Web Storage. DOM Storage foi desenhado para proporcionar uma alternativa mais segura e fácil de usar, para o armazenamento de informações em cookies. Atualmente ela está disponível somente nos navegadores baseados no Mozilla e WebKit, começando notavelmente com o Firefox 2 e o Safari 4.
Descrição
O mecanismo DOM Storage é um meio através do qual pares de strings de chaves/valores podem ser armazenados com segurança e mais tarde recuperados para uso. A meta desta adição é proporcionar um meio compreensível através do qual aplicações interativas possam ser construídas (incluindo habilidades avançadas, tal como ser capaz de trabalhar "offline" por períodos de tempo maiores).
Atualmente, somente navegadores baseados no Mozilla, Internet Explorer 8 beta 2 e Safari (não outros navegadores baseados em webkit, por exemplo, o Google Chrome) proporcionam um trabalho de implementação da especificação do DOM Storage. O Internet Explorer anterior a versão 8 tem uma característica similar chamada "userData behavior" que permite guardar dados através de múltiplas sessões do navegador.
Dom Storage é útil porque não existem métodos diretamente nos navegadores, bons para guardar quantidades de dados razoáveis por qualquer período de tempo. Os cookies do navegador (Browser cookies) tem uma capacidade limitada e não proporcionam suporte para organizar dados armazenados, e outros métodos (tal como Flash Local Storage) que requerem um plugin externo.
Umas dos primeiros aplicativos públicos a fazer uso da nova funcionalidade DOM Storage (em adição ao userData Behavior do Internet Explorer) foi o halfnote (um aplicativo de tomada de notas) escrito por Aaron Boodman. Em seu aplicativo, Aaron simultaneamente salvava notas no servidor (quando a conexão a internet estava disponível) e em um armazenamento local de dados. Isto permitia ao usuário escrever seguramente, cópias de notas mesmo com uma conexão esporádica à internet.
Embora o conceito e implementação apresentados no halfnote seja comparativamente simples, sua criação mostra a possibilidade para uma nova geração de aplicativos web que sejam utilizáveis tanto online quanto offline.
Referência
A seguir vem objetos globais que existem como propriedades de todos os window
object. Isto significa que eles podem ser acessados por sessionStorage
ou window.sessionStorage
. (Isto é importante porque você pode então usar IFrames para armazenar, ou acessar, dados adicionais, além do que está imediatamente incluído em sua página).
Storage
Este é um construtor (Storage
) para todas as instâncias Storage (sessionStorage
e globalStorage[location.host]).
Storage.prototype.removeKey = function(key){ this.removeItem(this.key(key)) }
assim configuradao, pode ser acessado como localStorage.removeKey e sessionStorage.removeKey
.
Itens globalStorage
não são instâncias de Storage
, e sim uma instância de StorageObsolete
.
Storage
é definido pelo WhatWG Storage Interface como:
interface Storage { readonly attribute unsigned long length; [IndexGetter] DOMString key(in unsigned long index); [NameGetter] DOMString getItem(in DOMString key); [NameSetter] void setItem(in DOMString key, in DOMString data); [NameDeleter] void removeItem(in DOMString key); void clear(); };
sessionStorage
Este é um objeto global (sessionStorage
) que mantém uma área de armazenamento disponível enquanto durar a sessão da página. Uma sessão de página dura enquanto o navegador estiver aberto e continua mesmo sobre recarregamentos e restaurações. Abrindo uma página em uma nova aba ou janela causará o início de uma nova sessão.
// Save data to a the current session's store sessionStorage.username = "John"; // Access some stored data alert( "username = " + sessionStorage.username );
O objeto sessionStorage
é útil para guardar dados temporários que devem ser salvos e restaurados se o navegador for atualizado acidentalmente.
Nas versões anteriores ao Firefox 3.5, os dados em sessionStorage não eram restaurados automaticamente depois de recuperar-se de uma quebra no navegador. A partir do Firefox 3.5, isto funciona como na especificação.
Exemplos:
Autosalvar o conteúdo de uma campo de texto, e se o navegador for atualizado acidentalmente , restaurar o conteúdo do campo de texto, não tendo perdas na escrita.
// Get the text field that we're going to track var field = document.getElementById("field"); // See if we have an autosave value // (this will only happen if the page is accidentally refreshed) if ( sessionStorage.autosave ) { // Restore the contents of the text field field.value = sessionStorage.autosave; } // Check the contents of the text field every second setInterval(function(){ // And save the results into the session storage object sessionStorage.autosave = field.value; }, 1000);
Mais informações:
globalStorage
Non-standard
This feature is non-standard and is not on a standards track. Do not use it on production sites facing the Web: it will not work for every user. There may also be large incompatibilities between implementations and the behavior may change in the future.
globalStorage
) que mantém múltiplas áreas de armazenamento privadas que podem ser usadas para guardar dados por um longo período de tempo (por exemplo, sobre múltiplas láginas e sessões do navegador).
globalStorage
não é uma instância de Storage
, mas uma instância StorageList
contendo instâncias StorageObsolete
.// Save data that only scripts on the mozilla.org domain can access globalStorage['mozilla.org'].snippet = "<b>Hello</b>, how are you?";
Especificamente, o objeto globalStorage
fornece acesso a um número de diferentes objetos de armazenamento em que os dados sejam armazenados. Por exemplo, se construirmos uma página web que use globalStorage
em seu domínio (developer.mozilla.org) é necessário termos o objeto de armazenamento a seguir disponível para nós:
globalStorage['developer.mozilla.org']
- Todas as páginas web com o subdomínio developer.mozilla.org podem tanto ler quanto escrever dados neste objeto de armazenamento.
O Firefox 2 passou a permitir acesso aos objetos de armazenamento superiores ao documento corrente na hierarquia do domínio. Por razões de segurança isto não é mais permitido no Firefox 3. Além disso, a proposta de adição ao HTML 5 foi removida da especificação do HTML 5 em favor de localStorage
, que foi implementado no Firefox 3.5.
Exemplos:
Todos estes exemplos requerem que você tenha uns script inserido (com o código seguinte) em todas as páginas que você quiser ver o resultado.
Lembrar o nome de usuário para o subdomínio particular que está sendo visitado:
globalStorage['developer.mozilla.org'].username = "John";
Manter o número de vezes que um usuário visitou todas as páginas do seu domínio:
// parseInt must be used since all data is stored as a string globalStorage['mozilla.org'].visits = parseInt( globalStorage['mozilla.org'].visits || 0 ) + 1;
localStorage
localStorage
é o mesmo que globalStorage[location.hostname]
, com a exceção de ser projetado para a origem do HTML 5 (esquema + nome do host + porta não padrão) e localStorage
é uma instância de Storage
diferente de globalStorage[location.hostname]
que é uma instância de StorageObsolete
. Por exemplo, https://example.com não está disponível para acessar o mesmo objeto localStorage
que https://example.com mas eles podem acessar o mesmo item globalStorage
. localStorage
é uma interface padrão enquanto globalStorage
não é padrão. localStorage
foi adicionada ao Firefox 3.5.
Por favor, note que configurar a propriedade globalStorage[location.hostname]
não a configura em localStorage
e por extensão Storage.prototype
não afeta itens globalStorage
, somente extendendo o que StorageObsolete.prototype
faz.
Mais informações
- Web Storage (W3C Web Apps Working Group)
- Enable/Disable DOM Storage in Firefox or SeaMonkey
Exemplos
- Basic DOMStorage Examples - Quebrado no Firefox 3 pelo uso de globalStorage em um nível de domínio acima do domínio atual, o que não é permitido no Firefox 3.
- halfnote - (exibido como quebrado no Firefox 3) Aplicativo de escrita de notas que usa DOM Storage.
- Noteboard - Aplicativo de escrita de notas que não armazena dados em um servidor. Todos os documentos são armazenados localmente. A tecla tab também trabalha na indentação de texto.
- jData - Um objeto de interface localStorage compartilhado que pode ser acessado através de qualquer website na internet e trabalha no Firefox 3+, Webkit 3.1.2+ nightlies e IE8. É como uma pseudo-globalStorage[""] em que o acesso a escrita precisa de confirmação do usuário.