--- title: Storage.key() slug: Web/API/Storage/key tags: - API - Méthode - Reference - Stockage - Storage - Web Storage translation_of: Web/API/Storage/key ---

{{APIRef()}}

La méthode key() de l'interface {{domxref("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 {{domxref("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
{{SpecName('HTML WHATWG', 'webstorage.html#dom-storage-key', 'Storage.key')}} {{Spec2('HTML WHATWG')}}  

Compatibilité des navigateurs

{{Compat("api.Storage.key")}}

Voir aussi