Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

localStorage — archiviazione locale dei dati

localStorage mette a disposizione del browser un archivio di coppie chiave-valore testuali associato a un’origine. I dati possono durare oltre una sessione, ma l’accesso e la persistenza dipendono dalle politiche del browser.

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.localStorage
localStorage.setItem(key, value)
localStorage.getItem(key)
localStorage.removeItem(key)

window.localStorage restituisce un oggetto Storage per l’origine della pagina. È una Web API definita dall’HTML Living Standard, non una funzionalità ECMAScript. I motori dei browser attuali la supportano; Node 24 nel repository non dimostra il supporto nei browser.

setItem(key, value) memorizza testo, getItem(key) restituisce testo oppure null e removeItem(key) elimina una voce. clear() elimina tutte le voci in quell’area di archiviazione, non solo quelle dell’applicazione.

A differenza di sessionStorage, i dati possono durare oltre una sessione ed essere condivisi tra finestre della stessa origine. Non è una copia di backup: l’utente o il browser possono eliminarli. Non dare per scontato che le operazioni di lettura–modifica–scrittura siano protette da un blocco. Le modifiche attivano un evento storage nelle altre finestre che usano quell’area di archiviazione, ma non nella finestra che scrive.

L’accesso stesso può generare SecurityError e la scrittura può generare QuotaExceededError: gestisci entrambi. Gli script della stessa origine possono leggere i dati, quindi non memorizzare qui segreti. Se le operazioni riescono, l’esempio scrive un valore associandolo a una chiave generata casualmente, lo rilegge ed elimina la voce senza ripristinare alcun valore precedente. Nell’esecuzione mostrata, l’accesso a window.localStorage genera un errore SecurityError prima che il codice arrivi alla scrittura.

Esempi

(() => {
  const key = `cktis-storage-${crypto.getRandomValues(new Uint32Array(4)).join('-')}`;
  try {
    const storage = window.localStorage;
    storage.setItem(key, 42);
    let stored;
    try {
      stored = storage.getItem(key);
    } finally {
      storage.removeItem(key);
    }
    console.log(`Stored as a string: ${stored === '42'}`);
    console.log(`Missing after removal: ${storage.getItem(key) === null}`);
  } catch (error) {
    console.log(`Storage unavailable: ${error.name}`);
  }
})();

Risultato

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