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.