Storage.getItem()

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 DOMString contenant 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
Unknown
La définition de 'getItem()' dans cette spécification.		 Statut inconnu  

Compatibilité des navigateurs

Nous convertissons les données de compatibilité dans un format JSON. Ce tableau de compatibilité utilise encore l'ancien format car nous n'avons pas encore converti les données qu'il contient. Vous pouvez nous aider en contribuant !

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

Utilisation de l'API de stockage web

 

Sujets associés