Array : méthode [Symbol.iterator]() - JavaScript | MDN

Basculer la barre latérale

Thème

Automatique
Clair
Sombre

Français

Se souvenir de la langue En savoir plus

Array : méthode [Symbol.iterator]()

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 septembre 2016.

La méthode [Symbol.iterator]() des instances de Array implémente le protocole itérable et permet aux tableaux d'être parcourus par la plupart des syntaxes qui attendent un itérable, comme la syntaxe de l'opérateur de propagation et les boucles for...of. Elle retourne un objet itérateur de tableau qui fournit la valeur de chaque indice du tableau.

La valeur initiale de cette propriété est la même fonction que la valeur initiale de la propriété Array.prototype.values.

Dans cet article

Exemple interactif

const array = ["a", "b", "c"];
const iterator = array[Symbol.iterator]();

for (const value of iterator) {
  console.log(value);
}

// Résultat attendu : "a"
// Résultat attendu : "b"
// Résultat attendu : "c"

Syntaxe

array[Symbol.iterator]()

Paramètres

Aucun.

Valeur de retour

La même valeur de retour que Array.prototype.values() : un nouvel objet d'itérateur itérable qui fournit la valeur de chaque indice du tableau.

Exemples

Itération avec une boucle for...of

Notez qu'il est rare d'avoir à appeler cette méthode directement. La présence de la méthode [Symbol.iterator]() rend les tableaux itérables, et les syntaxes d'itération comme la boucle for...of appellent automatiquement cette méthode pour obtenir l'itérateur à parcourir.

HTML

html

JavaScript

js
const arr = ["a", "b", "c"];
const letterResult = document.getElementById("letterResult");
for (const letter of arr) {
  const li = document.createElement("li");
  li.textContent = letter;
  letterResult.appendChild(li);
}

Résultat

Utiliser manuellement l'itérateur

Vous pouvez toujours appeler manuellement la méthode next() de l'objet itérateur retourné pour avoir un contrôle maximal sur le processus d'itération.

js
const arr = ["a", "b", "c", "d", "e"];
const arrIter = arr[Symbol.iterator]();
console.log(arrIter.next().value); // a
console.log(arrIter.next().value); // b
console.log(arrIter.next().value); // c
console.log(arrIter.next().value); // d
console.log(arrIter.next().value); // e

Gérer les chaînes de caractères et les tableaux de chaînes avec la même fonction

Puisque les chaînes de caractères et les tableaux implémentent le protocole itérable, il est possible de concevoir une fonction générique pour traiter les deux types d'entrée de la même manière. Cela est préférable à l'appel direct de Array.prototype.values(), qui nécessite que l'entrée soit un tableau ou au moins un objet possédant cette méthode.

js
function logIterable(it) {
  if (typeof it[Symbol.iterator] !== "function") {
    console.log(it, "n'est pas itérable.");
    return;
  }
  for (const letter of it) {
    console.log(letter);
  }
}

// Tableau
logIterable(["a", "b", "c"]);
// a
// b
// c

// Chaîne de caractères
logIterable("abc");
// a
// b
// c

// Nombre
logIterable(123);
// 123 n'est pas itérable.

Guide des collections indexées
L'objet global Array
La méthode Array.prototype.keys()
La méthode Array.prototype.entries()
La méthode Array.prototype.values()
La méthode TypedArray.prototype[Symbol.iterator]()
La méthode String.prototype[Symbol.iterator]()
La propriété Symbol.iterator
Protocoles d'itération
Prothèse d'émulation de Array.prototype[Symbol.iterator] dans core-js (angl.)

Aider à améliorer MDN

Cette page vous a-t-elle été utile ?

Oui Non

Apprendre à contribuer

Cette page a été modifiée le 5 nov. 2025 par les contributeur·ice·s du MDN.

Voir cette page sur GitHub • Signaler un problème avec ce contenu

Objets natifs standards
Array
Constructeur
1. Array()
Méthodes statiques
Propriétés statiques
1. [Symbol.species]
Méthodes d'instance
Propriétés d'instance
1. length
2. [Symbol.unscopables]
Héritage
Object/Function
Méthodes statiques
Propriétés statiques
Méthodes d'instance
Propriétés d'instance
1. Object.prototype.__proto__
2. Object.prototype.constructor