Window.localStorage
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
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:oudata:, 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("monChat");
La syntaxe pour la suppression de l'élément localStorage est la suivante :
localStorage.removeItem("monChat");
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
| Specification |
|---|
| HTML Standard # dom-localstorage-dev |
Compatibilité des navigateurs
BCD tables only load in the browser