Storage.getItem()

Cet article nécessite une relecture rédactionnelle. Voici comment vous pouvez aider.

Cette traduction est incomplète. Aidez à traduire cet article depuis l'anglais.

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é dont vous souhaitez retrouver la valeur.

Renvoie

Une DOMString contenant la valeur de la clé. Si la clé n'existe pas, null est renvoyé.

Exemple

La fonction suivante récupère trois données du stockage local, puis les utilise pour changer le style d'une 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 Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
localStorage 4 3.5 8 10.50 4
sessionStorage 5 2 8 10.50 4
Fonctionnalité Android Firefox Mobile (Gecko) IE Phone Opera Mobile Safari Mobile
Basic support 2.1 ? 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)

 

Étiquettes et contributeurs liés au document

Étiquettes : 
 Contributeurs à cette page : EmilienD
 Dernière mise à jour par : EmilienD,