Iterator : méthode [Symbol.iterator]()
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 septembre 2016.
La méthode [Symbol.iterator]() des instances de Iterator implémente le protocole itérable et permet aux itérateurs intégrés d'être consommés par la plupart des syntaxes s'attendant à des objets itérables, comme la syntaxe de décomposition et les boucles for...of. Elle retourne la valeur de this, qui est l'objet itérateur lui-même.
Syntaxe
iterator[Symbol.iterator]()
Paramètres
Aucun.
Valeur de retour
La valeur de this, qui est l'objet itérateur lui-même.
Exemples
Itérer avec une boucle for...of
Notez que vous avez rarement besoin d'appeler cette méthode directement. L'existence de la méthode [Symbol.iterator]() rend les itérateurs intégrés itérables, et les syntaxes d'itération comme la boucle for...of appellent automatiquement cette méthode pour obtenir l'itérateur à parcourir.
const tableauIterateur = [1, 2, 3].values();
for (const valeur of tableauIterateur) {
console.log(valeur);
}
// Affiche : 1, 2, 3
Spécifications
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-%iteratorprototype%-%symbol.iterator% |
Compatibilité des navigateurs
Voir aussi
- L'objet
Iterator - La propriété statique
Symbol.iterator - Protocole d'itération