Méthode JavaScript Array.fromAsync()
Exemple
Créer un tableau à partir d'un itérable asynchrone :
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(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émentthisArg(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
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
(async () => {
const result = await Array.fromAsync(set);
console.log(result); // Sortie : [1, 2, 3]
})();
Exemple 3 : Utilisation d'une fonction de mappage
Exemple
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
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
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é !
Autres extensions
Objet Array JavaScript