Promise.race()

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

Promise.race() принимает итерируемую коллекцию промисов, чаще всего — массив.

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

Создадим несколько промисов, завершающихся без ошибок.

        
          
          const slow = new Promise(resolve => setTimeout(() => resolve(1), 6000))const fast = new Promise(resolve => setTimeout(() => resolve(2), 3000))const theFastest = new Promise(resolve => setTimeout(() => resolve(3), 1000))
          const slow = new Promise(resolve => setTimeout(() => resolve(1), 6000))
const fast = new Promise(resolve => setTimeout(() => resolve(2), 3000))
const theFastest = new Promise(resolve => setTimeout(() => resolve(3), 1000))

        
        
          
            
            Скопировать
            Скопировано
            Не удалось скопировать
          
        
      

Передадим массив из созданных промисов в Promise.race():

        
          
          Promise.race([slow, fast, theFastest])  .then((value) => {    console.log(value)    // 3  })
          Promise.race([slow, fast, theFastest])
  .then((value) => {
    console.log(value)
    // 3
  })

        
        
          
            
            Скопировать
            Скопировано
            Не удалось скопировать
          
        
      

В консоль запишется результат выполнения theFastest, так как он выполнился быстрее всех.

Создадим несколько промисов, где theFastest завершается с ошибкой.

        
          
          const slow = new Promise(  resolve => setTimeout(() => resolve(1), 6000))const fast = new Promise(  resolve => setTimeout(() => resolve(2), 3000))const theFastest = new Promise(  (resolve, reject) => setTimeout(() => reject('Some error'), 1000))
          const slow = new Promise(
  resolve => setTimeout(() => resolve(1), 6000)
)
const fast = new Promise(
  resolve => setTimeout(() => resolve(2), 3000)
)
const theFastest = new Promise(
  (resolve, reject) => setTimeout(() => reject('Some error'), 1000))

        
        
          
            
            Скопировать
            Скопировано
            Не удалось скопировать
          
        
      

Передадим массив из созданных промисов в Promise.race():

        
          
          Promise.race([slow, fast, theFastest])  .then((value) => {    console.log(value)    // Промис с ошибкой завершился быстрее —    // эта часть проигнорируется  })  .catch((error) => {    console.log(error)    // 'Some error'  })
          Promise.race([slow, fast, theFastest])
  .then((value) => {
    console.log(value)
    // Промис с ошибкой завершился быстрее —
    // эта часть проигнорируется
  })
  .catch((error) => {
    console.log(error)
    // 'Some error'
  })

        
        
          
            
            Скопировать
            Скопировано
            Не удалось скопировать
          
        
      

В консоль запишется результат выполнения theFastest, так как он завершился быстрее всех.

Если передать в Promise.race() пустой список, то промис навсегда зависнет в состоянии pending:

        
          
          Promise.race([])  .then((value) => {    console.log(value)    // then никогда не сработает  })  .catch((error) => {    console.log(error)    // catch никогда не сработает  })
          Promise.race([])
  .then((value) => {
    console.log(value)
    // then никогда не сработает
  })
  .catch((error) => {
    console.log(error)
    // catch никогда не сработает
  })

        
        
          
            
            Скопировать
            Скопировано
            Не удалось скопировать
          
        
      

Создадим массив, где theFastest — завершённый промис, а 3 — элемент, не являющийся промисом.

        
          
          const slow = new Promise(  resolve => setTimeout(() => resolve(1), 6000))const theFastest = Promise.resolve(2)const promises = [slow, theFastest, 3]
          const slow = new Promise(
  resolve => setTimeout(() => resolve(1), 6000)
)
const theFastest = Promise.resolve(2)

const promises = [slow, theFastest, 3]

        
        
          
            
            Скопировать
            Скопировано
            Не удалось скопировать
          
        
      

Передадим массив из созданных промисов в Promise.race():

        
          
          Promise.race(promises)  .then((value) => {    console.log(value)    // 2  })
          Promise.race(promises)
  .then((value) => {
    console.log(value)
    // 2
  })

        
        
          
            
            Скопировать
            Скопировано
            Не удалось скопировать
          
        
      

В консоль запишется результат выполнения theFastest, так как в массиве он был первым завершённым промисом. Если поменять порядок элементов, результат изменится:

        
          
          const promises = [slow, 3, theFastest]Promise.race(promises)  .then((value) => {    console.log(value)    // 3  })
          const promises = [slow, 3, theFastest]

Promise.race(promises)
  .then((value) => {
    console.log(value)
    // 3
  })

        
        
          
            
            Скопировать
            Скопировано
            Не удалось скопировать
          
        
      

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

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

Создадим ещё раз несколько промисов, где theFastest завершается с ошибкой:

        
          
          const slow = new Promise(  resolve => setTimeout(() => resolve(1), 6000))const fast = new Promise(  resolve => setTimeout(() => resolve(2), 3000))const theFastest = new Promise(  (resolve, reject) => setTimeout(() => reject('Some error'), 1000))
          const slow = new Promise(
  resolve => setTimeout(() => resolve(1), 6000)
)
const fast = new Promise(
  resolve => setTimeout(() => resolve(2), 3000)
)
const theFastest = new Promise(
  (resolve, reject) => setTimeout(() => reject('Some error'), 1000)
)

        
        
          
            
            Скопировать
            Скопировано
            Не удалось скопировать
          
        
      

Передадим массив из созданных промисов в Promise.any():

        
          
          Promise.any([slow, fast, theFastest])  .then((value) => {    console.log(value)    // 2  })  .catch((error) => {    console.log(error)    // Сюда мы не попадём  })
          Promise.any([slow, fast, theFastest])
  .then((value) => {
    console.log(value)
    // 2
  })
  .catch((error) => {
    console.log(error)
    // Сюда мы не попадём
  })

        
        
          
            
            Скопировать
            Скопировано
            Не удалось скопировать
          
        
      

В консоль запишется результат выполнения fast, так как он выполнился быстрее всех и без ошибки. Этот же пример, но с использованием Promise.race() попадает в catch().