KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

AggregateError: meerdere fouten in één uitzondering

AggregateError bundelt fouten van een verzamelbewerking en bewaart de afzonderlijke fouten plus een optioneel bericht en oorzaak.

Versie: ECMAScript 2026 draft; example target: Node.js 24.22.2

Syntax

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

new AggregateError(errors, message, options) verbruikt het iterabele errors en bewaart de waarden in de array errors. message is optionele tekst en options.cause legt een oorzaak op hoger niveau vast. De constructor retourneert een foutobject en werpt de opgenomen fouten niet automatisch.

Gebruik dit wanneer één bewerking op meerdere onafhankelijke plaatsen kan mislukken, zoals Promise.any. Afhandeling loopt gewoonlijk door error.errors. Een niet-iterabel eerste argument werpt TypeError; de elementen hoeven geen Error-objecten te zijn.

Een leeg iterable is geldig. Zonder message hoeft de instantie geen eigen eigenschap met die naam te hebben; cause ontstaat alleen wanneer die is opgegeven. Het voorbeeld combineert twee foutklassen met behoud van het verzamelbericht.

Voorbeelden

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

Resultaat

AggregateError
Import failed
Error,TypeError
batch-7

Bronnen