CKTIS / JavaScript
AggregateError: wiele błędów w jednym wyjątku
AggregateError grupuje błędy z operacji zbiorczych, zachowując osobną listę przyczyn oraz opcjonalny komunikat i cause.
Wersja: ECMAScript 2026 draft; example target: Node.js 24.22.2
Składnia
new AggregateError(errors[, message[, options]])new AggregateError(errors, message, options) pobiera iterowalne errors i zapisuje jego elementy w tablicy errors. message jest opcjonalnym tekstem, a options.cause opisuje nadrzędną przyczynę. Konstruktor zwraca nowy obiekt błędu; nie zgłasza automatycznie zawartych błędów.
Używaj go, gdy jedna operacja może zawieść w kilku niezależnych miejscach, np. Promise.any. Łapanie AggregateError powinno zwykle obejmować iterację po error.errors. Przekazanie wartości nieiterowalnej jako pierwszego argumentu powoduje TypeError; elementy kolekcji nie muszą być obiektami Error.
Pusta kolekcja jest dozwolona. Bez message obiekt nie musi mieć własnej właściwości message; cause istnieje tylko wtedy, gdy podano ją w opcjach. Przykład tworzy dwa różne błędy i pokazuje ich nazwy bez utraty komunikatu zbiorczego.
Przykłady
const failures = [new Error("disk"), new TypeError("format")];
const error = new AggregateError(failures, "Import failed", {cause: "batch-7"});
console.log(error.name);
console.log(error.message);
console.log(error.errors.map(item => item.name).join(","));
console.log(error.cause);Wynik
AggregateError Import failed Error,TypeError batch-7