Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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

Źródła