Promise.race()

Метод Promise.race(iterable) возвращает выполненое или отклоненое обещание, в зависимости от того, с каким результатом завершится первое из переданных обещаний, со значением или причиной отклонения этого обещания.

Синтакс

Promise.race(iterable);

Параметры

iterable

Итерируемый объект, такой как (Array). Смотри iterable.

Возвращаемое значение

Выполненный или отклоненный Promise в зависимости от результата первого завершенного из переданных в итерируемом объекте обещаний.

Описание

Метод race  возвращает Обещание (Promise) с результатом, первого завершенного из переданных обещаний. Т.е. возвратит resolve или reject, в зависимости от того, что случится первым.

Примеры

Использование Promise.race – пример с setTimeout

var p1 = new Promise(function(resolve, reject) { 
    setTimeout(resolve, 500, "один"); 
});
var p2 = new Promise(function(resolve, reject) { 
    setTimeout(resolve, 100, "два"); 
});

Promise.race([p1, p2]).then(function(value) {
  console.log(value); // "два"
  // Оба вернули resolve, однако p2 вернул результат первым
});

var p3 = new Promise(function(resolve, reject) { 
    setTimeout(resolve, 100, "три");
});
var p4 = new Promise(function(resolve, reject) { 
    setTimeout(reject, 500, "четыре"); 
});

Promise.race([p3, p4]).then(function(value) {
  console.log(value); // "три"
  // p3 быстрее, поэтому выведется значение его resolve               
}, function(reason) {
  // Не вызывается
});

var p5 = new Promise(function(resolve, reject) { 
    setTimeout(resolve, 500, "пять"); 
});
var p6 = new Promise(function(resolve, reject) { 
    setTimeout(reject, 100, "шесть");
});

Promise.race([p5, p6]).then(function(value) {
  // Не вызывается
}, function(reason) {
  console.log(reason); // "шесть"
  // p6 быстрее, выводится его rejects
});

Спецификации

Совместимость с браузерами

	Desktop Browsers					Mobile Browsers
	Chrome for Desktop	Firefox for Desktop	Internet Explorer for Desktop	Opera for Desktop	Safari for Desktop	Android Browser	Chrome for Android	Firefox for Android	Internet Explorer Mobile	Opera Mobile	Safari for iOS
Базовая поддержка	32.0Полная поддержка	29.0Полная поддержка	НетНет поддержки	19.0Полная поддержка	7.1Полная поддержка	НетНет поддержки	32.0Полная поддержка	29.0Полная поддержка	НетНет поддержки	НетНет поддержки	8.0Полная поддержка

Легенда

Полная поддержка 

Полная поддержка

Нет поддержки 

Нет поддержки

Смотрите также

• Promise