Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

sessionStorage — armazenamento da sessão do separador

sessionStorage armazena pares de chave e valor em formato de texto para uma origem e uma sessão de separador. É adequado para estados temporários, como um rascunho de formulário, mas o acesso ao armazenamento ou a escrita podem falhar.

Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxe

window.sessionStorage
sessionStorage.setItem(key, value)
sessionStorage.getItem(key)
sessionStorage.removeItem(key)
sessionStorage.clear()

window.sessionStorage devolve um objeto Storage associado a uma origem e a uma sessão de separador. Os dados mantêm-se após recarregar a página. Ao contrário de localStorage, não se destina a manter estados entre sessões. Separadores distintos têm armazenamentos distintos; uma nova janela auxiliar pode receber inicialmente uma cópia dos dados da janela que a abriu, mas as alterações posteriores são independentes.

As operações são síncronas. setItem(key, value) armazena texto, getItem(key) devolve texto ou null e removeItem(key) elimina uma entrada. clear() elimina todas as entradas desse armazenamento, não apenas os dados de um componente — utiliza-o com cuidado.

O acesso a sessionStorage pode lançar SecurityError, por exemplo, devido a uma política do navegador ou a uma origem opaca. A escrita pode lançar QuotaExceededError. Trata as exceções e não consideres o armazenamento como a única cópia de dados importantes nem como um local para segredos a que apenas um script deva ter acesso.

Esta é uma API Web definida em HTML, não uma funcionalidade de uma edição específica de ECMAScript. A norma indica suporte em todos os motores de navegador atuais; a presença de Node 24 num repositório não comprova o suporte desta API do navegador.

Exemplos

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Session storage access and draft values</title>
</head>
<body>
  <script>
    const frame = document.createElement('iframe');
    frame.title = 'Session storage test';
    frame.setAttribute('sandbox', 'allow-scripts');
    frame.srcdoc = `<!doctype html>
<html lang="en">
<head><meta charset="utf-8"><title>Draft storage</title></head>
<body>
  <p role="status"></p>
  <script>
    let message;
    try {
      const storage = window.sessionStorage;
      const key = 'cktis:sessionStorage:draft';
      const previous = storage.getItem(key);
      try {
        storage.setItem(key, 'draft');
        const saved = storage.getItem(key);
        storage.removeItem(key);
        message = 'Saved: ' + saved + '; removed: ' + (storage.getItem(key) === null);
      } finally {
        if (previous === null) storage.removeItem(key);
        else storage.setItem(key, previous);
      }
    } catch (error) {
      message = 'Session storage unavailable: ' + error.name;
    }
    document.querySelector('[role="status"]').textContent = message;
    console.log(message);
  <\/script>
</body>
</html>`;
    document.body.append(frame);
  </script>
</body>
</html>

Resultado

Session storage unavailable: SecurityError

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes