Promise.withResolvers()

Overview

The Promise.withResolvers() static method is an alternative to the Promise() constructor that returns both the promise and resolution functions. You can use this to access resolve and reject outside the scope of the executor function.

Browser support

Syntax

const { promise, resolve, reject } = Promise.withResolvers();

// Resolve from an event handler
button.addEventListener('click', () => resolve('clicked'));
setTimeout(() => reject(new Error('timeout')), 5000);

const result = await promise;

Live demo

Use cases

• Using Promise.withResolvers()

  The Promise.withResolvers() static method is an alternative to the Promise() constructor that returns both the promise and resolution functions. You can use this to access resolve and reject outside the scope of the executor function.

Cautions

Accessibility

• When updating the DOM dynamically, announce important changes to assistive technology with aria-live regions.

Related links

• MDN Web Docs - Promise.withResolvers()

Powered by web-features