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.

AggregateError 객체는 다수의 오류가 한 오류로 포장되어야 할 때의 오류를 나타냅니다. 한 작업에서 여러 개의 오류가 보고될 때 발생하는데, 대표적으로 Promise.any()에 전달된 모든 프로미스가 거부되었을 때 발생합니다.

AggregateError은 Error의 하위 클래스 입니다.

생성자

AggregateError(): 새로운AggregateError 객체를 생성합니다.

인스턴스 속성

인스턴스 속성은 부모인 Error로부터 상속받습니다.

아래 속성은 AggregateError.prototype에 정의되어 있으며 모든 인스턴스 객체와 공유합니다.

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

명세서

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