Window.localStorage

La proprietà read-only localStorage ti permette di accedere all'oggetto Storage per l'origine del Document; i dati persistono anche tra diverse sessioni browser. localStorage è simile a sessionStorage, ma si differenzia dal fatto che i dati salvati con localStoragenon hanno  expiration time, i dati salvati in sessionStorage vengono cancellati al termine della sessione della pagina — cioé, quando la pagina viene chiusa.

Si dovrebbe notare che i dati salvati in entrambi localStoragesessionStorage sono specifici rispetto al protocollo della pagina.

Sintassi

myStorage = window.localStorage;

Valore

L'oggetto Storage che puo essere usato per accedere alla memoria del localStorage.

Eccezioni

SecurityError
La richiesta viola la policy decision, o l'origine non è un valido scheme/host/port tuple (può succedere, per esempio, se l'origine usa lo schemafile:data: ). Per esempio, l'utente può aver il browser configurato a negare i permessi di dati persistenti.

Esempi

Il seguente snippet accede all'oggetto local Storage del dominio e aggiunge i dati usando Storage.setItem().

localStorage.setItem('myCat', 'Tom');

La sintassi per leggere localStorage è la seguente:

var cat = localStorage.getItem("myCat");

La sintassi per rimuovere dati da localStorage è la seguente:

localStorage.removeItem("myCat");

Note: Riferimenti di esempi completi all'articolo: Usare lo Web Storage API.

Specifiche

Specifiche Status Commento
HTML Living Standard
The definition of 'localStorage' in that specification.
Living Standard  

Compatibilità browser

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help! (en-US)

Funzionalità Chrome Edge Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
localStorage 4 (Yes) 3.5 8 10.50 4
sessionStorage 5 (Yes) 2 8 10.50 4
Feature Android Edge Firefox Mobile (Gecko) IE Phone Opera Mobile Safari Mobile
Basic support 2.1 (Yes) ? 8 11 iOS 3.2

Tutti i browsers hanno livelli di capacità vari per entrambilocalStorage e sessionStorage (en-US). Qui una dettagliata lista di tutte le capacità di vari browser.

Note: A partire da iOS 5.1, Safari Mobile salva i dati di localStorage nella cartella cache, che è soggetta a rimozioni occasionali. Safari Mobile in Private mode previene la scrittura al localStorage.

Consulta anche