JavaScript Promise.race()

Definition and Usage

Promise.race() Methods return a Promise from a group of Promises, when the fastest Promise completes (resolved or rejected).

Instance

// Create a Promise
const myPromise1 = new Promise((resolve, reject) => {
  setTimeout(resolve, 200, "King");
});
// Create another Promise
const myPromise2 = new Promise((resolve, reject) => {
  setTimeout(resolve, 100, "Queen");
});
// When the fastest Promise completes
Promise.race([myPromise1, myPromise2]).then((x) => {
  myDisplay(x);
});

Try It Yourself

Syntax

Promise.race(iterable)

Parameter

Return Value

Browser Support

Promise.race() Is a feature of ECMAScript 6 (ES6).

Since June 2017, ES6 (JavaScript 2015) is supported in all modern browsers:

Promise.race() Not Supported by Internet Explorer.