Méthode JavaScript Array.fromAsync()

Array 对象参考手册Objet Array JavaScript


Exemple

Créer un tableau à partir d'un itérable asynchrone :

const asyncIterable = (async function* () { for (let i = 0; i < 5; i++) { await new Promise((resolve) => setTimeout(resolve, 10 * i)); yield i; } })(); Array.fromAsync(asyncIterable).then((array) => console.log(array)); // [0, 1, 2, 3, 4]

Essayez-le vous-même »

Définition et utilisation

Array.fromAsync() est une méthode statique relativement récente en JavaScript qui vous permet de créer un nouveau tableau à partir d'un itérable asynchrone, d'un itérable ou d'un objet semblable à un tableau. Cette méthode renvoie une Promise qui se résout en une nouvelle instance de tableau.

En termes simples, il s'agit de la version asynchrone de Array.from(), spécifiquement conçue pour gérer les sources de données asynchrones.


Syntaxe de base

Array.fromAsync(asyncIterable)
Array.fromAsync(iterable)
Array.fromAsync(arrayLike)
Array.fromAsync(asyncIterable, mapFn)
Array.fromAsync(asyncIterable, mapFn, thisArg)

Description du paramètre

  • asyncIterable: Un itérable asynchrone (comme un générateur asynchrone)
  • iterable: Un itérable (comme un tableau, une chaîne, un Set, etc.)
  • arrayLike: Un objet semblable à un tableau (un objet avec une propriété length et des éléments indexés)
  • mapFn(Facultatif) : Une fonction de mappage qui est appelée sur chaque élément
  • thisArg(Facultatif) : La valeur à utiliser comme this lors de l'exécution de mapFn

Valeur de retour

Renvoie une Promise qui se résout en un nouveau tableau.


Prise en charge des navigateurs

Array.fromAsync() est une fonctionnalité relativement récente qui, en 2023, n'est prise en charge que dans les versions récentes des navigateurs :

  • Chrome 117+
  • Firefox 115+
  • Safari 16.4+
  • Node.js 21+

Pour les environnements non pris en charge, vous pouvez utiliser un polyfill ou implémenter vous-même une fonctionnalité similaire.

Les nombres dans le tableau indiquent la première version du navigateur qui prend en charge la méthode.

Méthode
fromAsync() 117+ 121+ 115+ 16.4+ 81.0+

Exemples d'utilisation

Exemple 1 : Créer un tableau à partir d'un générateur asynchrone

Exemple

async function* asyncGenerator() {
  yield 1;
  yield 2;
  yield 3;
}

(async () => {
  const result = await Array.fromAsync(asyncGenerator());
  console.log(result); // Sortie : [1, 2, 3]
})();

Exemple 2 : Créer un tableau à partir d'un itérable standard

Exemple

const set = new Set([1, 2, 3]);

(async () => {
  const result = await Array.fromAsync(set);
  console.log(result); // Sortie : [1, 2, 3]
})();

Exemple 3 : Utilisation d'une fonction de mappage

Exemple

async function* asyncNumbers() {
  yield 1;
  yield 2;
  yield 3;
}

(async () => {
  const result = await Array.fromAsync(asyncNumbers(), x => x * 2);
  console.log(result); // Sortie : [2, 4, 6]
})();

Différences par rapport à Array.from()

Bien que Array.fromAsync() et Array.from() se ressemblent, ils présentent plusieurs différences importantes :

1. Gestion des sources de données asynchrones

Array.fromAsync() peut gérer les itérables asynchrones, tandis que Array.from() ne le peut pas.

2. Valeur de retour

Array.from() renvoie directement un tableau, tandis que Array.fromAsync() renvoie une Promise.

3. Moment de l’exécution

Array.from() s’exécute de manière synchrone, tandis que Array.fromAsync() s’exécute de manière asynchrone.


Scénarios d'application pratiques

Scénario 1 : Gestion des données d’API paginées

Exemple

async function* paginatedFetcher() {
  let page = 1;
  while (true) {
    const response = await fetch(`https://api.example.com/data?page=${page}`);
    const data = await response.json();
    if (data.length === 0) break;
    yield* data;
    page++;
  }
}

(async () => {
  const allData = await Array.fromAsync(paginatedFetcher());
  console.log(allData); // Fusionner les données de toutes les pages en un seul tableau
})();

Scénario 2 : Gestion des résultats de plusieurs opérations asynchrones

Exemple

const promises = [
  Promise.resolve(1),
  Promise.resolve(2),
  Promise.resolve(3)
];

(async () => {
  const results = await Array.fromAsync(promises);
  console.log(results); // Sortie : [1, 2, 3]
})();

Résumé

Array.fromAsync() est un outil puissant, particulièrement adapté à la gestion des collections de données asynchrones. Il simplifie le processus de création de tableaux à partir de sources de données asynchrones, rendant le code plus propre et plus facile à maintenir. Bien que la prise en charge par les navigateurs ne soit pas encore généralisée, avec le temps, elle deviendra l'une des méthodes standard pour gérer les collections de données asynchrones.

N'oubliez pas que, lorsque vous devez créer un tableau à partir d'une source de données asynchrone, Array.fromAsync() est votre bon allié !

Array 对象参考手册Objet Array JavaScript

Autres extensions