AggregateError

Объект AggregateError представляет ошибку, когда несколько ошибок необходимо объединить в одну. Она выбрасывается, когда операция должна сообщить о нескольких ошибках, например, с помощью Promise.any(), когда все переданные ей промисы отклоняются.

По сравнению с SuppressedError, AggregateError представляет собой список несвязанных ошибок, тогда как SuppressedError представляет ошибку, произошедшую во время обработки другой ошибки.

AggregateError является подклассом Error.

Конструктор

AggregateError()

Создает новый объект AggregateError.

Свойства экземпляра

Также наследует свойства экземпляра от своего родителя Error.

Эти свойства определены в AggregateError.prototype и являются общими для всех экземпляров AggregateError.

AggregateError.prototype.constructor

Функция-конструктор, создавшая объект экземпляра. Для экземпляров AggregateError начальным значением является конструктор AggregateError.

AggregateError.prototype.name

Представляет имя типа ошибки. Для AggregateError.prototype.name начальным значением является "AggregateError".

Эти свойства являются собственными свойствами каждого экземпляра AggregateError.

errors

Массив, представляющий ошибки, которые были агрегированы.

Методы экземпляра

Наследует методы экземпляра от своего родителя Error.

Примеры

Перехват AggregateError

Promise.any([Promise.reject(new Error("some error"))]).catch((e) => {
  console.log(e instanceof AggregateError); // true
  console.log(e.message); // "All Promises rejected"
  console.log(e.name); // "AggregateError"
  console.log(e.errors); // [ Error: "some error" ]
});

Создание AggregateError

try {
  throw new AggregateError([new Error("some error")], "Hello");
} catch (e) {
  console.log(e instanceof AggregateError); // true
  console.log(e.message); // "Hello"
  console.log(e.name); // "AggregateError"
  console.log(e.errors); // [ Error: "some error" ]
}

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

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

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

• Полифил AggregateError в core-js
• es-shims полифил AggregateError
• Error
• Promise.any