Window.localStorage

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.

Voir aussi

Étiquettes et contributeurs liés au document

 Contributeurs à cette page : Nolwennig, goofy_bz, mfrederic
 Dernière mise à jour par : Nolwennig,