@ungap/promise-all-settled

What is @ungap/promise-all-settled?

The @ungap/promise-all-settled npm package is a polyfill for the Promise.allSettled method, which is a part of the ECMAScript 2020 specification. This method returns a promise that resolves after all of the given promises have either fulfilled or rejected, with an array of objects that each describe the outcome of each promise.

What are @ungap/promise-all-settled's main functionalities?

Polyfill for Promise.allSettled

This code demonstrates how to use the @ungap/promise-all-settled package to polyfill the Promise.allSettled method. It shows an array of promises, some of which resolve and one that rejects. Promise.allSettled is used to handle all the promises, and the results are logged to the console.

require('@ungap/promise-all-settled');

const promises = [
  Promise.resolve(33),
  new Promise(resolve => setTimeout(() => resolve(66), 0)),
  99,
  Promise.reject(new Error('an error'))
];

Promise.allSettled(promises).then(results => console.log(results));

Other packages similar to @ungap/promise-all-settled

promise.allsettled

This package provides a shim for the Promise.allSettled method. It offers similar functionality to @ungap/promise-all-settled, allowing users to wait for all promises to settle. The main difference is that it may have different polyfill implementations and support.

bluebird

Bluebird is a fully-featured promise library with a variety of powerful methods for handling asynchronous operations. It includes its own version of allSettled, called 'reflect', which can be used to achieve similar results. Bluebird is more heavyweight compared to @ungap/promise-all-settled, which serves a single polyfill purpose.

q

Q is another well-known promise library that provides a method called 'allSettled' for similar functionality. It is a more comprehensive promise management library, so it includes many additional features beyond what @ungap/promise-all-settled offers.

README

Promise.allSettled

A cross platform Promise.allSettled polyfill.

• CDN global utility via https://unpkg.com/@ungap/promise-all-settled
• ESM via import allSettled from '@ungap/promise-all-settled'
• CJS via const allSettled = require('@ungap/promise-all-settled')

Example

const allSettled = require("@ungap/promise-all-settled");

// use it via call
allSettled.call(Promise, []);

// or bind it:
const $settled = allSettled.bind(Promise);

// or put it in the Promise class
if (!Promise.allSettled)
  Promise.allSettled = allSettled;