CKTIS / JavaScript
Promise.allSettled — résultats de toutes les promesses
Promise.allSettled accepte un objet itérable et renvoie une promesse contenant un tableau des résultats de tous ses éléments. Elle conserve l’ordre d’entrée et enregistre aussi bien les valeurs des promesses tenues que les motifs de rejet.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
Promise.allSettled(iterable)Promise.allSettled(iterable) est une méthode statique disponible depuis ECMAScript 2020, et non une API Web distincte. Elle accepte un objet itérable synchrone, comme un tableau, et traite ses éléments selon Promise.resolve. Les valeurs ordinaires sont donc également des entrées valides. La prise en charge par le navigateur cible doit être vérifiée séparément ; la version de Node utilisée dans un dépôt ne la prouve pas.
La promesse renvoyée est tenue avec un tableau une fois que tous les éléments sont réglés, par accomplissement ou par rejet. Les résultats suivent l’ordre d’entrée, et non celui de leur règlement. Chaque résultat est soit { status: "fulfilled", value: ... }, soit { status: "rejected", reason: ... }. Vérifiez status avant de lire value ou reason.
Contrairement à Promise.all, le rejet d’un élément ne rejette pas la promesse agrégée. Cela ne signifie pas que cette méthode ne peut jamais la rejeter : une entrée invalide, comme null, ou une exception pendant l’itération peut provoquer un rejet. Si l’itération se termine sans erreur mais qu’au moins un élément ne se règle jamais, la promesse agrégée reste en attente.
Avec une entrée vide, la promesse renvoyée est déjà tenue avec [], mais une fonction transmise à .then s’exécute tout de même de façon asynchrone. La méthode n’annule pas les opérations et ne limite pas la concurrence ; elle en recueille les résultats.
Exemples
const inputs = [Promise.resolve(10), Promise.reject("offline"), 30];
Promise.allSettled(inputs).then((results) => {
console.log(JSON.stringify(results));
});Résultat
[{"status":"fulfilled","value":10},{"status":"rejected","reason":"offline"},{"status":"fulfilled","value":30}]Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.