La méthode keys() renvoie un nouvel objet Array Iterator qui contient les clefs pour chaque indice du tableau.

var arr = ["a", "b", "c"]
var iterateur = arr.keys();

console.log(iterateur.next()); { value: 0, done: false }
console.log(iterateur.next()); { value: 1, done: false }
console.log(iterateur.next()); { value: 2, done: false }
console.log(iterateur.next()); { value: undefined, done: true }

Syntaxe

arr.keys()

Valeur de retour

Un nouvel objet itérateur pour Array.

Exemples

Utilisation simple

var arr = ["a","b","c"];
var itérateur = arr.keys();

console.log(itérateur.next()); // { value: 0, done: false }
console.log(itérateur.next()); // { value: 1, done: false }
console.log(itérateur.next()); // { value: 2, done: false }
console.log(itérateur.next()); // { value: undefined, done: true }

Un itérateur de clés prend en compte les trous

var arr = ["a", , "c"];
var clésCreuses = Object.keys(arr);
var clésDenses = [...arr.keys()];
console.log(clésCreuses); // ["0", "2"]
console.log(clésDenses);  // [0, 1, 2]

Spécifications

Spécification État Commentaires
ECMAScript 2015 (6th Edition, ECMA-262)
La définition de 'Array.prototype.keys' dans cette spécification.
Standard Définition initiale.
ECMAScript Latest Draft (ECMA-262)
La définition de 'Array.prototype.keys' dans cette spécification.
Standard évolutif  

Compatibilité des navigateurs

FonctionnalitéChromeEdgeFirefoxInternet ExplorerOperaSafari
Support simple38 (Oui)28 Non257.1
FonctionnalitéAndroidChrome for AndroidEdge mobileFirefox for AndroidIE mobileOpera AndroidiOS Safari
Support simple (Oui) (Oui) (Oui)28 Non (Oui)8.0

Voir aussi

Étiquettes et contributeurs liés au document

 Contributeurs à cette page : SphinxKnight, teoli, quentin.lamamy
 Dernière mise à jour par : SphinxKnight,