Promise.allSettled()

Overview

Promise.allSettled() waits until every Promise settles and returns each outcome as an object. Unlike Promise.all(), one rejected task does not fail the whole batch.

Browser support

Syntax

const results = await Promise.allSettled([
  fetch('/api/users'),
  fetch('/api/posts'),
  fetch('/api/comments'),
]);

const successful = results
  .filter(r => r.status === 'fulfilled')
  .map(r => r.value);

const failed = results
  .filter(r => r.status === 'rejected')
  .map(r => r.reason);

Live demo

Use cases

• Batch requests with mixed outcomes

  Load independent dashboard panels or resources together, then render whichever results succeeded.

• End-of-run summaries

  Collect every success and failure so a job report can show what needs retrying without losing successful work.

Cautions

Accessibility

• If some tasks succeed while others fail, communicate both states clearly instead of announcing only a single generic result.

Related links

• MDN Web Docs - Promise.allSettled()

Powered by web-features