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

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
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,