Window : propriété localStorage
Baseline
Widely available
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.
La propriété en lecture seule localStorage de l'interface window permet d'accéder à l'objet Storage du Document d'origine ; les données stockées sont conservées entre les sessions du navigateur.
localStorage est similaire à sessionStorage, sauf que les données de localStorage n'ont pas de date d'expiration, tandis que les données de sessionStorage sont effacées lorsque la session de la page se termine — c'est-à-dire lorsque la page est fermée. (Les données de localStorage pour un document chargé dans une session de « navigation privée » ou « incognito » sont effacées lorsque le dernier onglet « privé » est fermé.)
Valeur
Un objet Storage qui peut être utilisé pour accéder à l'espace de stockage local de l'origine actuelle.
Exceptions
SecurityError-
Levée dans l'un des cas suivants :
- L'origine n'est pas un schéma/hôte/port valide. Cela peut se produire si l'origine utilise les schémas
file:oudata:, par exemple. - La requête viole une décision de politique. Par exemple, l'utilisateur·ice a configuré le navigateur pour empêcher la page de conserver des données.
Notez que si l'utilisateur·ice bloque les cookies, les navigateurs interpréteront probablement cela comme une instruction pour empêcher la page de conserver des données.
- L'origine n'est pas un schéma/hôte/port valide. Cela peut se produire si l'origine utilise les schémas
Description
Les clés et les valeurs stockées avec localStorage sont au format de chaîne de caractères UTF-16. Comme pour les objets, les clés entières sont automatiquement converties en chaînes de caractères.
Les données de localStorage sont spécifiques au protocole du document. En particulier, pour un site chargé avec HTTP (par exemple, http://example.com), localStorage retourne un objet différent de celui de localStorage pour le site correspondant chargé avec HTTPS (par exemple, https://example.com).
Pour les documents chargés à partir d'URL file: (c'est-à-dire des fichiers ouverts dans le navigateur directement depuis le système de fichiers local de l'utilisateur·ice, plutôt que servis par un serveur web), les exigences pour le comportement de localStorage ne sont pas définies et peuvent varier selon les navigateurs.
Dans tous les navigateurs actuels, localStorage semble retourner un objet différent pour chaque URL file:. En d'autres termes, chaque URL file: semble avoir sa propre zone de stockage local unique. Mais il n'y a aucune garantie à ce sujet, donc vous ne devriez pas vous y fier, car, comme mentionné ci-dessus, les exigences pour les URL file: restent indéfinies. Il est donc possible que les navigateurs modifient leur gestion des URL file: pour localStorage à tout moment. En fait, certains navigateurs ont modifié leur gestion à ce sujet au fil du temps.
Exemples
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 :
const monChat = 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 :
localStorage.clear();
Note : Se référer à l'article Utiliser l'API Web Storage pour voir un exemple complet.
Spécifications
| Specification |
|---|
| HTML # dom-localstorage-dev |
Compatibilité des navigateurs
Voir aussi
- Utiliser l'API Web Storage
- La propriété
Window.sessionStorage