Traduzione in corso.
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 localStorage o sessionStorage è specifico 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
| Feature | 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.