La méthode getItem() de l'interface Storage renvoie la valeur associée à la clé passée en paramètre.
Syntax
var aValue = storage.getItem(keyName);
Paramètre
keyName- Une
DOMStringcontenant le nom de la clé voulue.
Renvoi
Une DOMString contenant la valeur de la clé. null est renvoyé si aucune correspondance n'est trouvée.
Exemple
La fonction suivante récupère trois élément du stockage local, puis réutilise les valeurs renvoyés afin de modifier le style de la page .
function setStyles() {
var currentColor = localStorage.getItem('bgcolor');
var currentFont = localStorage.getItem('font');
var currentImage = localStorage.getItem('image');
document.getElementById('bgcolor').value = currentColor;
document.getElementById('font').value = currentFont;
document.getElementById('image').value = currentImage;
htmlElem.style.backgroundColor = '#' + currentColor;
pElem.style.fontFamily = currentFont;
imgElem.setAttribute('src', currentImage);
}
Note: Pour voir cette fonction utilisée dans un exemple réel, dirigez-vous vers notre Demo de Stockage Web (en).
Spécifications
| Spécification | État | Commentaire |
|---|---|---|
| Web Storage (Second edition) La définition de 'getItem()' dans cette spécification. |
Recommendation |
Compatibilité des navigateurs
| Fonctionnalité | Chrome | Edge | Firefox (Gecko) | Internet Explorer | Opera | Safari (WebKit) |
|---|---|---|---|---|---|---|
| localStorage | 4 | (Oui) | 3.5 | 8 | 10.50 | 4 |
| sessionStorage | 5 | ? | 2 | 8 | 10.50 | 4 |
| Fonctionnalité | Android | Edge | Firefox Mobile (Gecko) | IE Phone | Opera Mobile | Safari Mobile |
|---|---|---|---|---|---|---|
| Basic support | 2.1 | (Oui) | ? | 8 | 11 | iOS 3.2 |
Tous les navigateurs ont des niveaux de capacité variables à la fois pour localStorage et sessionStorage. Voici une revue détaillée de toutes les capacités de stockage pour différents navigateurs (en).
Note: depuis iOS 5.1, Safari Mobile stocke les données localStorage dans le dossier de cache, lequel est sujet à un nettoyage occasionnel, sur décision de l'OS, typiquement par manque de place.
Voir aussi
Utiliser l'API de Stockage Web (en)