La méthodekeys() des instances deArray retourne un nouvel objetitérateur de tableau qui contient les clés pour chaque indice du tableau.

Exemple interactif

const array = ["a", "b", "c"];const iterator = array.keys();for (const key of iterator) {  console.log(key);}// Résultat attendu : 0// Résultat attendu : 1// Résultat attendu : 2

Syntaxe

keys()

Paramètres

Aucun.

Valeur de retour

Un nouvelobjet itérateur itérable.

Description

Lorsqu'elle est utilisée sur untableau creux, la méthodekeys() itère sur les emplacements vides comme s'ils avaient la valeurundefined.

La méthodekeys() estgénérique. Elle attend uniquement que la valeur dethis possède une propriétélength et des propriétés à clés entières.

Exemples

Utiliserkeys() sur un tableau creux

Contrairement àObject.keys(), qui n'inclut que les clés effectivement présentes dans le tableau, l'itérateurkeys() ne saute pas les trous représentant des propriétés manquantes.

const arr = ["a", , "c"];const sparseKeys = Object.keys(arr);const denseKeys = [...arr.keys()];console.log(sparseKeys); // ['0', '2']console.log(denseKeys); // [0, 1, 2]

Appelerkeys() sur des objets qui ne sont pas des tableaux

La méthodekeys() lit la propriétélength dethis puis génère tous les indices entiers de 0 àlength - 1. Aucun accès aux indices n'est réellement effectué.

const objetSimilaireTableau = {  length: 3,};for (const entry of Array.prototype.keys.call(objetSimilaireTableau)) {  console.log(entry);}// 0// 1// 2

Spécifications

Compatibilité des navigateurs

Voir aussi

• Guide des collections indexées
• L'objet globalArray
• La méthodeArray.prototype.entries()
• La méthodeArray.prototype.values()
• Array.prototype[Symbol.iterator]()
• La méthodeTypedArray.prototype.keys()
• Les protocoles d'itération
• Prothèse d'émulation deArray.prototype.keys dans core-js^(angl.)
• Prothèse d'émulation es-shims deArray.prototype.keys^(angl.)