La propriété localStorage vous permet d'accéder à un objet local Storage. Le localStorage est similaire au sessionStorage. La seul différence : les données stockées dans le localStorage n'ont pas de délai d'expiration, les données stockées dans le sessionStorage sont nettoyées quand la session navigateur prend fin — donc quand on ferme le navigateur.
Syntaxe
monStockage = localStorage;
Valeur
Un objet Storage.
Exemple
L'extrait de code suivant accède à l'objet local Storage du domaine courant et lui ajoute une entrée en utilisant Storage.setItem().
localStorage.setItem('monChat', 'Tom');
Note: Se référer à l'article Using the Web Storage API pour voir un exemple complet.
Spécifications
| Spécification | Statut | Commentaire |
|---|---|---|
| Web Storage (Second edition) La définition de 'localStorage' dans cette spécification. |
Recommendation |
Compatibilité navigateurs
| Fonctionnalité | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari (WebKit) |
|---|---|---|---|---|---|
| localStorage | 4 | 3.5 | 8 | 10.50 | 4 |
| sessionStorage | 5 | 2 | 8 | 10.50 | 4 |
| Fonctionnalité | Android | Firefox Mobile (Gecko) | IE Phone | Opera Mobile | Safari Mobile |
|---|---|---|---|---|---|
| Support basique | 2.1 | ? | 8 | 11 | iOS 3.2 |
Tous les navigateurs ont des capacités de stockage variables que ce soit pour le localStorage ou pour le sessionStorage. Le lien suivant permet de tester la capacité de stockage des différents navigateurs : detailed rundown of all the storage capacities for various browsers.
Note : à partir d'iOS 5.1, Safari Mobile stocke les données du localStorage dans le dossier de cache du navigateur. Ce dernier peut être sujet à d'occasionnels nettoyages à la convenance du système, notamment lorsque l'espace de stockage restant est faible. La navigation privée sur Safari Mobile ne permet pas d'accéder à l'écriture dans le localStorage.