Cette page a été traduite à partir de l'anglais par la communauté.Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.
Array : méthode entries()
Baseline Widely available
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.
La méthodeentries() des instances deArray retourne un nouvel objetitérateur de tableau qui contient les paires clé/valeur pour chaque indice du tableau.
Exemple interactif
const array = ["a", "b", "c"];const iterator = array.entries();console.log(iterator.next().value);// Sortie attendue : Array [0, "a"]console.log(iterator.next().value);// Sortie attendue : Array [1, "b"]Syntaxe
entries()Paramètres
Aucun.
Valeur de retour
Un nouvel objetd'itération.
Description
Lorsqu'elle est utilisée sur destableaux creux, la méthodeentries() itère sur les cases vides comme si elles avaient la valeurundefined.
La méthodeentries() estgénérique. Elle attend seulement que la valeur dethis possède une propriétélength et des propriétés à clés entières.
Exemples
Parcourir un tableau avec ses index et éléments
const arr = ["a", "b", "c"];for (const [index, element] of arr.entries()) { console.log(index, element);}// 0 "a"// 1 "b"// 2 "c"Bouclefor...of
const array = ["a", "b", "c"];const arrayEntries = array.entries();for (const element of arrayEntries) { console.log(element);}// [0, 'a']// [1, 'b']// [2, 'c']Itération sur des tableaux creux
entries() parcourt les cases vides comme si elles valaientundefined.
for (const element of [, "a"].entries()) { console.log(element);}// [0, undefined]// [1, 'a']Appel deentries() sur des objets qui ne sont pas des tableaux
La méthodeentries() lit la propriétélength dethis puis accède à chaque propriété dont la clé est un entier non négatif inférieur àlength.
const objetSimilaireTableau = { length: 3, 0: "a", 1: "b", 2: "c", 3: "d", // ignoré par entries() car length vaut 3};for (const entry of Array.prototype.entries.call(objetSimilaireTableau)) { console.log(entry);}// [ 0, 'a' ]// [ 1, 'b' ]// [ 2, 'c' ]Spécifications
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-array.prototype.entries |
Compatibilité des navigateurs
Voir aussi
- Guide des collections indexées
- L'objet global
Array - La méthode
Array.prototype.keys() - La méthode
Array.prototype.values() Array.prototype[Symbol.iterator]()- La méthode
TypedArray.prototype.entries() - Protocoles d'itération
- Prothèse d'émulation de
Array.prototype.entriesdanscore-js(angl.) - Prothèse d'émulation es-shims de
Array.prototype.entries(angl.)