blob: e8ccb332ecb4ad82987db005260510bf04882d6b (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
|
---
title: Window.localStorage
slug: Web/API/Window/localStorage
tags:
- API
- Propriété
- Reference
- Stockage
- Stockage Web
- Window
- WindowLocalStorage
- lecture seule
- localStorage
translation_of: Web/API/Window/localStorage
---
{{APIRef("Web Storage API")}}
La propriété `localStorage` vous permet d'accéder à un objet local {{domxref("Storage")}}. Le `localStorage` est similaire au [`sessionStorage`](/en-US/docs/Web/API/Window.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
```js
monStockage = localStorage;
```
### Valeur
Un objet {{DOMxRef("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](/fr/docs/Web/Security/Same_origin_policy_for_JavaScript) (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 {{domxref("Storage")}} du domaine courant et lui ajoute une entrée en utilisant {{domxref("Storage.setItem()")}}.
```js
localStorage.setItem('monChat', 'Tom');
```
La syntaxe pour la lecture de l'article `localStorage` est la suivante :
```js
var cat = localStorage.getItem('myCat');
```
La syntaxe pour la suppression de l'élément `localStorage` est la suivante :
```js
localStorage.removeItem('myCat');
```
La syntaxe pour supprimer tous les éléments de `localStorage` est la suivante :
```js
// Effacer tous les éléments
localStorage.clear();
```
> **Note :** Se référer à l'article [Using the Web Storage API](/en-US/docs/Web/API/Web_Storage_API/Using_the_Web_Storage_API) pour voir un exemple complet.
## Spécifications
| Spécification | Statut | Commentaire |
| -------------------------------------------------------------------------------------------------------- | -------------------------------- | ----------- |
| {{SpecName("HTML WHATWG", "webstorage.html#dom-localstorage", "localStorage")}} | {{Spec2("HTML WHATWG")}} | |
## Compatibilité navigateurs
{{Compat("api.Window.localStorage")}}
## Voir aussi
- [Using the Web Storage API](/en-US/docs/Web/API/Web_Storage_API/Using_the_Web_Storage_API)
- {{domxref("Storage/LocalStorage")}}
- {{domxref("Window/SessionStorage")}}
- {{domxref("Window.sessionStorage")}}
|
