Promise.allSettled(promises) waits until every promise in the list has settled, fulfilled or rejected, and then fulfills with an array of result objects in input order. A fulfilled entry looks like { status: 'fulfilled', value }; a rejected one looks like { status: 'rejected', reason }. Because failures become entries in the report, the returned promise never rejects.
Remember
Promise.allSettled([a, b]) -> one promise, never rejects
{ status: 'fulfilled', value: ... }
{ status: 'rejected', reason: ... }
results keep input order
[] -> fulfills with []
Syntax
Call it on Promise with an array (or any iterable) of promises.
0: fulfilled -> database ok
1: rejected -> cache offline
2: fulfilled -> disk ok
How It Works
A rejected promise in the list.Promise.reject() fails right away. It is not reported as unhandled, because allSettled attaches its own handler in the same moment.
Wait for the slowest check. The disk check takes 30 ms. allSettled waits for it, even though the cache check has already failed.
Branch on status. Each result object has a status. Fulfilled entries carry value; rejected entries carry reason, here an Error whose message we wrote.
Example 2 — allSettled() Compared with all()
The same three jobs, one of which breaks, given to both methods.
uploaded: 2, failed: 1
setup.exe is not allowed
["cat.png uploaded","notes.txt uploaded"]
How It Works
No try/catch needed. Because allSettled never rejects, the await line cannot throw because of a failed upload.
Filter by status. One filter() keeps the fulfilled entries and reads value; the other keeps the rejected entries and reads reason.message.
Report both groups. The user learns that two files worked and exactly which file was refused, instead of a single error for the whole batch.
Compatibility
Browser & Runtime Support
Promise.allSettled() was added in ES2020.
✓ Widely available · ES2020
Promise.allSettled()
Supported in all current browsers and in Node.js 12.9 and newer. The examples were run on Node.js 24.
WideAll current browsers
Google ChromeChrome 76+
Supported
Mozilla FirefoxFirefox 71+
Supported
Apple SafariSafari 13+
Supported
Microsoft EdgeEdge 79+
Supported
Node.jsNode.js 12.9+
Supported
DenoRecent versions
Supported
Internet ExplorerNo support
Not supported
Promise.allSettled()Very good
Bottom line: Safe for current browsers. Very old browsers (before 2019 or 2020) need a polyfill or a small helper that maps each promise with then and catch.
Frequently Asked Questions
Not because of the promises you pass in. It waits for all of them and fulfills with a report, even if every one of them rejected.
An object with a status property. Fulfilled entries are { status: "fulfilled", value }, rejected entries are { status: "rejected", reason }.
Promise.all rejects as soon as one promise rejects and loses the other values. allSettled always waits for every promise and tells you how each one ended.
Filter the results for status === "fulfilled" and map each entry to its value property.
On success they finish together. On failure, allSettled still waits for the slowest task; Promise.all stops at the first rejection.