La méthode key() de l'interface Storage prend un nombre n en argument et retourne la n-ième clé contenue dans storage. L'ordre des clés étant définie par le navigateur, il est recommandé de ne pas s'y référer .

Syntax

var unNomDeCle = storage.key(cle);

Paramètres

cle
Un entier représentant le numéro de la clé voulue. L'index débute à zero.

Valeur de retour

Un DOMString contenant le nom de la clé .

Exemple

La fonction suivante parcours les éléments présents dans le local storage.

function forEachKey(callback) {
  for (var i = 0; i < localStorage.length; i++) {
    callback(localStorage.key(i));
  }
}

Note: Pour un exemple plus poussé, consultez la Web Storage Demo.

Autre exemple

La fonction suivante parcourt chaque clé présente dans le localStorage et affiche les valeurs correspondantes.

for (var i = 0; i < localStorage.length; i++) {
   console.log(localStorage.getItem(localStorage.key(i)));
}

Specifications

Specification Status Comment
HTML Living Standard
La définition de 'Storage.key' dans cette spécification.
Standard évolutif  

Browser compatibility

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
Support basique 2.1 (Oui) ? 8 11 iOS 3.2

Notez que les niveaux de capacités de localStorage et sessionStorage sont propres à chaque navigateur. Vous pourrez trouver ici un article détaillé sur toutes les capacités de stockage de différents navigateurs.

Note: Depuis iOS 5.1, Safari Mobile réalise ses enregistrements de données type localStorage dans le cache du navigateur, faisant objet de remises à zéro occasionelles gérés par l'OS, le plus souvent lorsque l'espace s'amoindrit.

Voir aussi

Utilisation de l'API de stockage web

Étiquettes et contributeurs liés au document

 Contributeurs à cette page : JNa0, Axnyff, Sofness
 Dernière mise à jour par : JNa0,