Что вернёт Promise.any, если все промисы будут отклонены?

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

Как это работает

• Метод подписывается на все промисы одновременно.
• Первый fulfilled-промис определяет результат.
• Отклонённые промисы игнорируются, пока есть шанс на успех.
• Когда все отклонены, собирается AggregateError с массивом errors.

Пример кода

const p1 = Promise.reject(new Error('fail 1'));
const p2 = Promise.reject(new Error('fail 2'));

Promise.any([p1, p2])
  .then(value => console.log('Успех:', value))
  .catch(err => {
    console.log(err.name); // AggregateError
    console.log(err.errors); // [Error: fail 1, Error: fail 2]
  });

// Если хотя бы один успешен:
Promise.any([p1, Promise.resolve('ok')])
  .then(v => console.log(v)); // 'ok'

Где применяется

Promise.any удобен, когда нужно получить результат из нескольких источников и достаточно первого успешного ответа: например, запрос к нескольким зеркалам API, резервным серверам или кэшам. Если все источники недоступны, AggregateError позволяет увидеть все причины сбоя сразу.

Итог: используйте Promise.any, когда важен первый успешный результат, а не все результаты сразу; при полном провале обрабатывайте AggregateError и его массив errors.