Iterator : méthode toArray()

Baseline 2025

Newly available

Depuis March 2025, cette fonctionnalité fonctionne sur les appareils et les versions de navigateur les plus récents. Elle peut ne pas fonctionner sur les appareils ou navigateurs plus anciens.

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

toArray()

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.

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.