API de stockage Web
- Page précédente API d'histoire Web
- Page suivante API Worker Web
L'API Web Storage est une syntaxe simple pour stocker et récupérer des données dans le navigateur. Elle est très facile à utiliser :
Instance
localStorage.setItem("name", "Bill Gates");
localStorage.getItem("name");
Tous les navigateurs supportent l'API Web Storage :
| Chrome | IE | Firefox | Safari | Opera |
|---|---|---|---|---|
| Chrome | IE/Edge | Firefox | Safari | Opera |
| Supporté | Supporté | Supporté | Supporté | Supporté |
Objet localStorage
L'objet localStorage fournit un accès à l'entreposage local de sites spécifiques. Il vous permet de stocker, lire, ajouter, modifier et supprimer des éléments de données pour ce domaine.
Les données stockées n'ont pas de date d'expiration et ne sont pas supprimées lorsque le navigateur est fermé.
Ces données seront disponibles pendant plusieurs jours, semaines et années.
Méthode setItem()
La méthode setItem() de localStorage stocke des données dans l'entreposage (storage).
Il accepte un nom et une valeur en tant que paramètres :
Instance
localStorage.setItem("name", "Bill Gates");
Méthode getItem()
La méthode getItem() de localStorage récupère des données d'entreposage (storage).
Il accepte un nom en tant que paramètre :
Instance
localStorage.getItem("name");
Objet sessionStorage
L'objet sessionStorage est identique à l'objet localStorage.
La différence réside dans le fait que l'objet sessionStorage stocke les données de session.
Les données seront supprimées lorsque le navigateur est fermé.
Instance
sessionStorage.getItem("name");
Méthode setItem()
La méthode setItem() de sessionStorage stocke des données d'entreposage (storage).
Il accepte un nom et une valeur en tant que paramètres :
Instance
sessionStorage.setItem("name", "Bill Gates");
Méthode getItem()
La méthode getItem() de sessionStorage récupère des données d'entreposage (storage).
Il accepte un nom en tant que paramètre :
Instance
sessionStorage.getItem("name");
Propriétés et méthodes de l'objet Storage
| Propriété/méthode | Description |
|---|---|
| key(n) | Retourne le nom de la clé stockée au n-ième emplacement. |
| length | Retourne le nombre d'éléments de données stockés dans l'objet Storage. |
| getItem(keyname) | Retourne la valeur de la clé spécifiée. |
| setItem(keyname, value) | Ajoute la clé au stockage, ou met à jour la valeur de la clé si elle existe déjà. |
| removeItem(keyname) | Supprime la clé de la mémoire de stockage. |
| clear() | Efface toutes les clés. |
Pages liées à l'API Web Storage
| Propriétés | Description |
|---|---|
| window.localStorage | Permet de sauvegarder des paires de clés/valeurs dans le navigateur Web. Stocke des données sans date d'expiration. |
| window.sessionStorage | Permet de sauvegarder des paires de clés/valeurs dans le navigateur Web. Stocke les données d'une session. |
- Page précédente API d'histoire Web
- Page suivante API Worker Web
