JavaScript Promise.race()

Example

// 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 faster promise settles
Promise.race([myPromise1, myPromise2]).then((x) => {
  myDisplay(x);
});
Try it Yourself »

Description

The Promise.race() method returns a Promise from a list of promises, when the faster promise settles.


Syntax

Promise.race(iterable)

Parameters

iterable An Array of promises

Return Value

Type Description
Object A new Promise Object


Browser Support

Promise.race() is an ECMAScript6 (ES6) feature.

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

Chrome 51 Edge 15 Firefox 54 Safari 10 Opera 38
May 2016 Apr 2017 Jun 2017 Sep 2016 Jun 2016

Promise.race() is not supported in Internet Explorer.


Copyright 1999-2023 by Refsnes Data. All Rights Reserved.