AggregateError

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2020.

* Some parts of this feature may have varying levels of support.

The AggregateError object represents an error when several errors need to be wrapped in a single error. It is thrown when multiple errors need to be reported by an operation, for example by Promise.any(), when all promises passed to it reject.

AggregateError is a subclass of Error.

Constructor

AggregateError(): Creates a new AggregateError object.

Instance properties

Also inherits instance properties from its parent Error.

These properties are defined on AggregateError.prototype and shared by all AggregateError instances.

AggregateError.prototype.constructor: The constructor function that created the instance object. For AggregateError instances, the initial value is the AggregateError constructor.
AggregateError.prototype.name: Represents the name for the type of error. For AggregateError.prototype.name, the initial value is "AggregateError".

These properties are own properties of each AggregateError instance.

errors: An array representing the errors that were aggregated.

Instance methods

Inherits instance methods from its parent Error.

Examples

Catching an 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" ]
});

Creating an 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" ]
}

Specifications

Specification
ECMAScript® 2026 Language Specification # sec-aggregate-error-objects

Browser compatibility

	Desktop					Mobile						Server
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox for Android	Opera Android	Safari on IOS	Samsung Internet	WebView Android	Deno	Node.js
`AggregateError`	85	85	79	71	14	85	79	60	14	14.0	85	1.2	15.0.0
`AggregateError`	85	85	79	71	14	85	79	60	14	14.0	85	1.2	15.0.0
`errors`	85	85	79	71	14	85	79	60	14	14.0	85	1.2	15.0.0
`serializable_object`	98 `AggregateError` serializes to the `Error` type, without additional properties.	98 `AggregateError` serializes to the `Error` type, without additional properties.	103 `AggregateError` serializes to the `AggregateError` type, with properties `name`, `message`, `cause`, and `errors`.	84 `AggregateError` serializes to the `Error` type, without additional properties.	17	98 `AggregateError` serializes to the `Error` type, without additional properties.	103 `AggregateError` serializes to the `AggregateError` type, with properties `name`, `message`, `cause`, and `errors`.	68 `AggregateError` serializes to the `Error` type, without additional properties.	17	18.0 `AggregateError` serializes to the `Error` type, without additional properties.	98 `AggregateError` serializes to the `Error` type, without additional properties.	No	No