La propriété localStorage vous permet d'accéder à un objet local Storage. Le localStorage est similaire au sessionStorage. La seule différence : les données stockées dans le localStorage n'ont pas de délai d'expiration, alors que 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
Unknown
La définition de 'localStorage' dans cette spécification.
Statut inconnu  

Compatibilité navigateurs

FonctionnalitéChromeEdgeFirefoxInternet ExplorerOperaSafari
Support simple4 Oui3.5810.54
FonctionnalitéAndroid webviewChrome for AndroidEdge mobileFirefox for AndroidOpera AndroidiOS SafariSamsung Internet
Support simple Oui Oui Oui Oui113.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 : begmans, Bpruneau, Axnyff, EmmanuelBeziat, Nolwennig, goofy_bz, mfrederic
Dernière mise à jour par : begmans,