Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Archiviazione del browser

L’archiviazione del browser comprende meccanismi dell’ambiente del browser che conservano dati sul client. Scopri la differenza tra localStorage e sessionStorage e il confine tra il linguaggio ECMAScript e le API Web.

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

localStorage.setItem(key, value);
localStorage.getItem(key);
localStorage.removeItem(key);

L’archiviazione del browser (browser storage) è una funzionalità dell’ambiente, non sintassi ECMAScript. La specifica ECMAScript descrive il linguaggio e la sua interazione con l’ambiente host; non definisce né localStorage né sessionStorage. La presenza di Node 24 in un repository non dimostra che queste interfacce siano disponibili nel browser di destinazione.

localStorage conserva coppie chiave-valore tra sessioni, mentre sessionStorage è legato alla sessione di una pagina in una scheda specifica. Entrambe le interfacce sono sincrone e memorizzano stringhe. getItem(key) restituisce null quando la chiave è assente. Gli oggetti possono essere salvati con JSON.stringify e letti con JSON.parse.

L’accesso dipende dall’origine della pagina e dalle policy del browser. I dati possono essere eliminati e le operazioni di accesso o scrittura possono generare un’eccezione. Non considerare questo archivio l’unica copia dei dati né un luogo in cui conservare segreti. La sezione Web Storage dello standard HTML di WHATWG definisce localStorage e sessionStorage e i loro metodi. Non è un riferimento per la compatibilità con i browser e non garantisce che queste interfacce siano disponibili nel browser di destinazione.

Esempi

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Browser storage example</title>
</head>
<body>
  <p>localStorage can persist across visits. sessionStorage is scoped to the page session in a tab. Both are browser APIs, not part of ECMAScript.</p>
  <ul aria-label="Storage check results">
    <li id="localStorage"></li>
    <li id="sessionStorage"></li>
  </ul>
  <script>
    const fixture = JSON.stringify({ theme: 'dark' });

    function checkStorage(name) {
      const result = document.getElementById(name);
      try {
        const store = window[name];
        // A fresh temporary key avoids reusing application keys. This sequence is not atomic:
        // another same-origin tab can change localStorage between calls.
        const key = `cktis:storage:example:${crypto.getRandomValues(new Uint32Array(4)).join('-')}`;
        if (store.getItem(key) !== null) {
          throw new Error('Temporary storage key already exists');
        }
        store.setItem(key, fixture);
        let saved;
        try {
          saved = store.getItem(key);
        } finally {
          store.removeItem(key);
        }
        if (saved !== fixture || store.getItem(key) !== null) {
          throw new Error('Round trip or cleanup failed');
        }
        result.textContent = `${name}: read back theme=${JSON.parse(saved).theme}; temporary key removed.`;
      } catch (error) {
        if (!(error instanceof DOMException) || !['SecurityError', 'QuotaExceededError'].includes(error.name)) {
          throw error;
        }
        result.textContent = `${name}: temporary write unavailable (${error.name}).`;
      }
      console.log(result.textContent);
    }

    checkStorage('localStorage');
    checkStorage('sessionStorage');
  </script>
</body>
</html>

Risultato

A successful check reports that it read back theme=dark and removed the temporary key. If the check catches a DOMException named SecurityError or QuotaExceededError, it reports that the temporary write is unavailable and includes the error name. Other errors, including a temporary-key collision or a detected round-trip or cleanup failure, are rethrown without a report for that storage area. If the localStorage check rethrows, the sessionStorage check does not run.

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