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 !

Ordinateur
Mobile

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