Promise.allSettled()

You’re reading the English version of this content since no translation exists yet for this locale. Help us translate this article!

The Promise.allSettled() method returns a promise that resolves after all of the given promises have either resolved or rejected, with an array of objects that each describes the outcome of each promise.

Syntax

Promise.allSettled(iterable);

Parameters

iterable
An iterable object, such as an Array, in which each member is a Promise.

Return value

A pending Promise that will be asynchronously fulfilled once every promise in the specified collection of promises has completed, either by successfully being fulfilled or by being rejected. At that time, the returned promise's handler is passed as input an array containing the outcome of each promise in the original set of promises.

For each outcome object, a status string is present. If the status is fulfilled, then a value is present. If the status is rejected, then a reason is present. The value (or reason) reflects what value each promise was fulfilled (or rejected) with.

Specifications

Specification Status Comment
Promise.allSettled() (TC39 Stage 4 Draft) Draft

Browser compatibility

Update compatibility data on GitHub
DesktopMobileServer
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidFirefox for AndroidOpera for AndroidSafari on iOSSamsung InternetNode.js
allSettled()Chrome Full support 76Edge No support NoFirefox Full support 71IE No support NoOpera ? Safari ? WebView Android Full support 76Chrome Android Full support 76Firefox Android No support NoOpera Android Full support YesSafari iOS ? Samsung Internet Android ? nodejs Full support 12.9.0

Legend

Full support  
Full support
No support  
No support
Compatibility unknown  
Compatibility unknown

Implementation Progress

The following table provides a daily implementation status for this feature, because this feature has not yet reached cross-browser stability. The data is generated by running the relevant feature tests in Test262, the standard test suite of JavaScript, in the nightly build, or latest release of each browser's JavaScript engine.

See also