Window.sessionStorage

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

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

js
// 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().

js
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.

js
// 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);
});

Nota: Por favor use o artigo Using the Web Storage API para um exemplo completo.

Especificações

Specification
HTML
# dom-sessionstorage-dev

Compatibilidade com navegadores

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
sessionStorage

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Veja também