[ Web Proxy ]
URL:
Viewing: https://developer.mozilla.org/fr/docs/Web/JavaScript/Reference/Global_Objects/Array/entries [Back]  [Original]

Array : mthode entries() - JavaScript | MDN

Cette page a t traduite partir de l'anglais par la communaut. Vous pouvez contribuer en rejoignant la communaut francophone sur MDN Web Docs.

View in English Always switch to English

Array : mthode entries()

Baseline Large disponibilit

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 mthode entries() des instances de Array retourne un nouvel objet itrateur de tableau qui contient les paires cl/valeur pour chaque indice du tableau.

Dans cet article

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

js
entries()

Paramtres

Aucun.

Valeur de retour

Un nouvel objet d'itration.

Description

Lorsqu'elle est utilise sur des tableaux creux, la mthode entries() itre sur les cases vides comme si elles avaient la valeur undefined.

La mthode entries() est gnrique. Elle attend seulement que la valeur de this possde une proprit length et des proprits cls entires.

Exemples

Parcourir un tableau avec ses index et lments

js
const arr = ["a", "b", "c"];

for (const [index, element] of arr.entries()) {
  console.log(index, element);
}

// 0 "a"
// 1 "b"
// 2 "c"

Boucle for...of

js
const array = ["a", "b", "c"];
const arrayEntries = array.entries();

for (const element of arrayEntries) {
  console.log(element);
}

// [0, 'a']
// [1, 'b']
// [2, 'c']

Itration sur des tableaux creux

entries() parcourt les cases vides comme si elles valaient undefined.

js
for (const element of [, "a"].entries()) {
  console.log(element);
}
// [0, undefined]
// [1, 'a']

Appel de entries() sur des objets qui ne sont pas des tableaux

La mthode entries() lit la proprit length de this puis accde chaque proprit dont la cl est un entier non ngatif infrieur length.

js
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' ]

Spcifications

Spcification
ECMAScript 2027 LanguageSpecification
# sec-array.prototype.entries

Compatibilit des navigateurs

Voir aussi


Web Proxy Viewer  |  New URL  |  Original Page