База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

AggregateError: няколко грешки в едно изключение

AggregateError групира грешки от обща операция и запазва списъка им, както и незадължителни съобщение и причина.

Версия: ECMAScript 2026 draft; example target: Node.js 24.22.2

Синтаксис

new AggregateError(errors[, message[, options]])

new AggregateError(errors, message, options) обхожда итерируемото errors и записва стойностите в масива errors. message е незадължителен текст, а options.cause е причина от по-високо ниво. Конструкторът връща обект за грешка и не хвърля автоматично съдържаните грешки.

Използвай го, когато една операция може да се провали независимо на няколко места, например Promise.any. Обработката обикновено обхожда error.errors. Неитерируем първи аргумент хвърля TypeError; елементите не са длъжни да бъдат обекти Error.

Празна колекция е валидна. Без message екземплярът може да няма собствено такова свойство; cause се създава само ако е подадена. Примерът комбинира два класа грешки и запазва общото съобщение.

Примери

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);

Резултат

AggregateError
Import failed
Error,TypeError
batch-7

Източници