Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

AggregateError: più errori in una sola eccezione

AggregateError raggruppa gli errori di un’operazione collettiva conservando elenco, messaggio e causa opzionali.

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

Sintassi

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

new AggregateError(errors, message, options) consuma l’iterabile errors e ne salva i valori nell’array errors. message è opzionale e options.cause registra una causa superiore. Il costruttore restituisce un oggetto errore e non lancia automaticamente gli errori contenuti.

Usalo quando un’operazione può fallire in più punti indipendenti, come Promise.any. La gestione percorre normalmente error.errors. Un primo argomento non iterabile genera TypeError; gli elementi non devono essere necessariamente oggetti Error.

Un iterabile vuoto è valido. Senza message l’istanza può non avere la proprietà omonima; cause viene creata solo se fornita. L’esempio unisce due classi di errore mantenendo il messaggio complessivo.

Esempi

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

Risultato

AggregateError
Import failed
Error,TypeError
batch-7

Fonti