JavaScript Promise.race()

Definition and usage

Promise.race() Methods return a Promise from a set of Promises, when the fastest Promise completes (fulfilled 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 in Internet Explorer.