Window.localStorage

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.

Il convient de noter que les données stockées dans localStorage ou sessionStorage sont spécifiques au protocole de la page.

Les clés et les valeurs sont toujours des chaînes de caractères (à noter que, comme pour les objets, les clés entières seront automatiquement converties en chaînes de caractères).

Syntaxe

monStockage = localStorage;

Valeur

Un objet Storage qui peut être utilisé pour accéder à l'espace de stockage local de l'origine actuelle.

Exceptions

SecurityError
La demande viole une décision politique, ou l'origine n'est pas un schéma/hôte/port valide (cela peut se produire si l'origine utilise le shéma file: ou data:, par exemple). Par exemple, l'utilisateur peut configurer son navigateur de manière à refuser la permission de conserver des données pour l'origine spécifiée.

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');

La syntaxe pour la lecture de l'article localStorage est la suivante :

var cat = localStorage.getItem('myCat');

La syntaxe pour la suppression de l'élément localStorage est la suivante :

localStorage.removeItem('myCat');

La syntaxe pour supprimer tous les éléments de localStorage est la suivante :

// Effacer tous les éléments
localStorage.clear();

Note: Se référer à l'article Using the Web Storage API pour voir un exemple complet.

Spécifications

Spécification Statut Commentaire
HTML Living Standard
La définition de 'localStorage' dans cette spécification.
Standard évolutif

Compatibilité navigateurs

Update compatibility data on GitHub
OrdinateurMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariWebview AndroidChrome pour AndroidFirefox pour AndroidOpera pour AndroidSafari sur iOSSamsung Internet
localStorageChrome Support complet 4Edge Support complet 12Firefox Support complet 3.5IE Support complet 8Opera Support complet 10.5Safari Support complet 4WebView Android Support complet ≤37Chrome Android Support complet 18Firefox Android Support complet 4Opera Android Support complet 11Safari iOS Support complet 3.2Samsung Internet Android Support complet 1.0

Légende

Support complet  
Support complet

Voir aussi