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.