Клавиша / esc

Promise.any()

Запускаем несколько промисов параллельно и дожидаемся первого успешного.

Время чтения: 5 мин

Кратко

Скопировано

Метод any — это один из статических методов объекта Promise. Его используют, когда нужно запустить несколько промисов параллельно и дождаться первого успешного разрешённого.

Как пишется

Скопировано

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

Возвращает значение первого успешно выполнившегося промиса.

Как понять

Скопировано

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

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

Также, в отличие от Promise.race(), который возвращает промис, содержащий значение первого завершённого (resolved или rejected), этот метод возвращает промис, содержащий значение первого успешно выполненного (resolved) промиса. Метод будет игнорировать исполнение промисов с ошибкой (rejection) вплоть до первого исполненного успешно (resolved).

Для чего можно использовать

Скопировано

Например, у нас есть 2 картинки и надо отобразить любую из них, которая загрузится быстрее:

        
          
          function fetchAndDecode(url) {  return fetch(url)    .then(response => {      if (!response.ok) {        throw new Error(`HTTP error! status: ${response.status}`)      } else {        return response.blob()      }    })}const coffee = fetchAndDecode('coffee.jpg')const tea = fetchAndDecode('tea.jpg')Promise.any([coffee, tea])  .then((value) => {    const objectURL = URL.createObjectURL(value)    const image = document.createElement('img')    image.src = objectURL    document.body.appendChild(image)  })  .catch((error) => {    console.error(error)  })
          function fetchAndDecode(url) {
  return fetch(url)
    .then(response => {
      if (!response.ok) {
        throw new Error(`HTTP error! status: ${response.status}`)
      } else {
        return response.blob()
      }
    })
}

const coffee = fetchAndDecode('coffee.jpg')
const tea = fetchAndDecode('tea.jpg')

Promise.any([coffee, tea])
  .then((value) => {
    const objectURL = URL.createObjectURL(value)
    const image = document.createElement('img')

    image.src = objectURL
    document.body.appendChild(image)
  })
  .catch((error) => {
    console.error(error)
  })

        
        
          
        
      

Успешное выполнение нескольких промисов

Скопировано

Создадим два промиса, второй выполнится раньше:

        
          
          const promise1 = new Promise(resolve => setTimeout(() => resolve(1), 5000))const promise2 = new Promise(resolve => setTimeout(() => resolve(2), 1000))
          const promise1 = new Promise(resolve => setTimeout(() => resolve(1), 5000))
const promise2 = new Promise(resolve => setTimeout(() => resolve(2), 1000))

        
        
          
        
      

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

        
          
          Promise.any([promise1, promise2])  .then((result) => {    console.log(result)  })// 2
          Promise.any([promise1, promise2])
  .then((result) => {
    console.log(result)
  })
// 2

        
        
          
        
      

Массив промисов пустой

Скопировано

Передадим пустой массив в Promise.any():

        
          
          Promise.any([])  .then((result) => {    console.log(result)  })  .catch(error => {    console.error(error)  })
          Promise.any([])
  .then((result) => {
    console.log(result)
  })
  .catch(error => {
    console.error(error)
  })

        
        
          
        
      

В итоге обработчик then() будет проигнорирован, и будет выполняться код из обработчика ошибок catch.

Один из промисов завершился ошибкой

Скопировано

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

В примере ниже, промис promise2 завершается с ошибкой:

        
          
          const promise1 = new Promise(resolve => setTimeout(() => resolve(1), 5000))const promise2 = new Promise((resolve, reject) => setTimeout(() => reject('error'), 1000))Promise.any([promise1, promise2])  .then((result) => {    console.log(result)    // 1  })  .catch(error => {    console.error(error)  })
          const promise1 = new Promise(resolve => setTimeout(() => resolve(1), 5000))
const promise2 = new Promise((resolve, reject) => setTimeout(() => reject('error'), 1000))

Promise.any([promise1, promise2])
  .then((result) => {
    console.log(result)
    // 1
  })
  .catch(error => {
    console.error(error)
  })

        
        
          
        
      

В итоге обработчик catch() будет проигнорирован, и будет выполняться код из обработчика ошибок then() со значением 1 в переменной result.

Все промисы завершились ошибкой

Скопировано

Метод Promise.any() завершится с ошибкой, если все переданные промисы завершатся с ошибкой.

В примере ниже, все промисы завершаются с ошибкой:

        
          
          const promise1 = new Promise((resolve, reject) => setTimeout(() => reject('error1'), 5000))const promise2 = new Promise((resolve, reject) => setTimeout(() => reject('error2'), 1000))Promise.any([promise1, promise2])  .then((result) => {    console.log(result)  })  .catch(error => {    console.error(error)    // AggregateError: All promises were rejected  })
          const promise1 = new Promise((resolve, reject) => setTimeout(() => reject('error1'), 5000))
const promise2 = new Promise((resolve, reject) => setTimeout(() => reject('error2'), 1000))

Promise.any([promise1, promise2])
  .then((result) => {
    console.log(result)
  })
  .catch(error => {
    console.error(error)
    // AggregateError: All promises were rejected
  })

        
        
          
        
      

В итоге обработчик then() будет проигнорирован, и будет выполняться код из обработчика ошибок catch().

Не промисы в массиве промисов

Скопировано

Если в Promise.any() передать не промисы, он вернёт первый переданный аргумент, независимо от его типа, в результат выполнения как есть (под капотом при этом произойдёт его преобразование с помощью метода Promise.resolve()).

Передадим в Promise.any() массив значений, которые не являются промисами:

        
          
          const number = 2const obj = {key: 'value'}const func = () => trueconst bool = falseconst nulled = nullconst undef = undefinedPromise.any([number, obj, func, bool, nulled, undef])  .then((result) => {    console.log(result)    // 2  })Promise.any([obj, func, bool, nulled, undef, number])  .then((result) => {    console.log(result)    // {key: 'value'}  })Promise.any([func, bool, nulled, undef, number, obj])  .then((result) => {    console.log(result)    // () => true  })Promise.any([bool, nulled, undef, number, obj, func])  .then((result) => {    console.log(result)    // false  })Promise.any([nulled, undef, number, obj, func, bool])  .then((result) => {    console.log(result)    // null  })Promise.any([undef, number, obj, func, bool, nulled])  .then((result) => {    console.log(result)    // undefined  })
          const number = 2
const obj = {key: 'value'}
const func = () => true
const bool = false
const nulled = null
const undef = undefined

Promise.any([number, obj, func, bool, nulled, undef])
  .then((result) => {
    console.log(result)
    // 2
  })

Promise.any([obj, func, bool, nulled, undef, number])
  .then((result) => {
    console.log(result)
    // {key: 'value'}
  })

Promise.any([func, bool, nulled, undef, number, obj])
  .then((result) => {
    console.log(result)
    // () => true
  })

Promise.any([bool, nulled, undef, number, obj, func])
  .then((result) => {
    console.log(result)
    // false
  })

Promise.any([nulled, undef, number, obj, func, bool])
  .then((result) => {
    console.log(result)
    // null
  })

Promise.any([undef, number, obj, func, bool, nulled])
  .then((result) => {
    console.log(result)
    // undefined
  })