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 localStorage
non 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 localStorage
o sessionStorage
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 schema
file:
odata:
). 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
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
. 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
.