Window.sessionStorage

A propriedade sessionStorage permite acessar um objeto tipo session Storage. A sessionStorage é similar ao localStorage, 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. A sessão da página dura enquanto o browser está aberto e se mantém no recarregamento da página. Abrir a página em uma nova aba ou nova janela, irá gerar uma nova sessão, o que diferencia de como os cookies trabalham.

Sintaxe

// Salva os dados na sessionStorage
sessionStorage.setItem('chave', 'valor');

// Obtém os dados da sessionStorage
var data = sessionStorage.getItem('chave');

Valor

Objeto Storage.

Exemplo

O seguinte trecho acessa o objeto da sessão do domínio atual Storage e adiciona um item usando o Storage.setItem().

sessionStorage.setItem('myCat', 'Tom');

O exemplo a seguir salva automaticamente o conteúdo da caixa de texto, e caso o browser seja acidentalmente recarregado, o conteúdo da caixa de texto é restaurado.

// Obtem a caixa de texto que vamos rastrear
var field = document.getElementById("campo");
 
// Se tivermos um valor salvo automaticamente
// (isto só ocorrerá se a página for acidentalmente recarregada)
if (sessionStorage.getItem("autosave")) {
  // Restaura o conteúdo da caixa de texto
  field.value = sessionStorage.getItem("autosave");
}
 
// Verifica as mudanças que ocorrem na caixa de texto
field.addEventListener("change", function() {
  // E salva o resultado dentro de um objeto session storage
  sessionStorage.setItem("autosave", field.value);
});

Especificações

Browser compatíveis

Cada browser 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.

Veja também

• Using the Web Storage API
• Window.localStorage