La méthode toArray() des instances de Iterator crée une nouvelle instance de Array remplie avec les éléments produits par l'itérateur.

Syntaxe

Paramètres

Aucun.

Valeur de retour

Une nouvelle instance de Array contenant les éléments de l'itérateur dans l'ordre dans lequel ils ont été produits.

Exemples

Utiliser la méthode toArray()

iterator.toArray() est équivalent à Array.from(iterator) et [...iterator], sauf qu'il est plus facile à chaîner lorsque plusieurs méthodes d'aide à l'itérateur sont impliquées. L'exemple suivant crée un itérateur qui produit les termes de la suite de Fibonacci, prend les 10 premiers termes, filtre les nombres impairs et convertit le résultat en tableau :

function* fibonacci() {
  let actuel = 1;
  let suivant = 1;
  while (true) {
    yield actuel;
    [actuel, suivant] = [suivant, actuel + suivant];
  }
}

const tableau = fibonacci()
  .take(10)
  .filter((x) => x % 2 === 0)
  .toArray();

console.log(tableau); // [2, 8, 34]

Notez qu'il est conseillé d'appeler toArray() en dernière étape de votre traitement. Par exemple, fibonacci().take(10).toArray().filter(...) est moins efficace, car les méthodes d'aide à l'itérateur sont paresseuses et évitent de créer un tableau temporaire.

Spécifications

Compatibilité des navigateurs

Voir aussi

• Prothèse d'émulation de Iterator.prototype.toArray dans core-js ^(angl.)
• Prothèse d'émulation es-shims de Iterator.prototype.toArray ^(angl.)
• L'objet Iterator
• La méthode statique Array.from()