Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

sessionStorage — archiviazione della sessione della scheda

sessionStorage memorizza coppie chiave-valore sotto forma di stringhe per un’origine e una sessione della scheda. È adatto a stati temporanei, come una bozza di modulo, ma l’accesso all’archiviazione o la scrittura possono non riuscire.

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

Sintassi

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

window.sessionStorage restituisce un oggetto Storage associato a un’origine e a una sessione della scheda. I dati restano disponibili dopo il ricaricamento della pagina. A differenza di localStorage, non è pensato per mantenere uno stato tra sessioni diverse. Le schede separate hanno archivi distinti; una nuova finestra ausiliaria può ricevere inizialmente una copia dei dati della finestra che l’ha aperta, ma le modifiche successive sono indipendenti.

Le operazioni sono sincrone. setItem(key, value) memorizza testo, getItem(key) restituisce testo o null e removeItem(key) elimina una voce. clear() elimina tutte le voci di quell’archivio, non solo i dati di un componente: usalo con cautela.

L’accesso a sessionStorage può generare SecurityError, ad esempio a causa di una policy del browser o di un’origine opaca. La scrittura può generare QuotaExceededError. Gestisci le eccezioni e non considerare l’archiviazione come l’unica copia di dati importanti né come un luogo per segreti accessibili a un solo script.

Questa è una Web API definita in HTML, non una funzionalità di una particolare edizione di ECMAScript. Lo standard indica il supporto in tutti i motori dei browser attuali; la presenza di Node 24 in un repository non dimostra il supporto di questa API del browser.

Esempi

<!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>

Risultato

Session storage unavailable: SecurityError

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti