AggregateError
Baseline
Ampliamente disponible
Esta característica está consolidada y funciona en muchos dispositivos y versiones de navegador. Está disponible en todos los navegadores desde septiembre de 2020.
El objeto AggregateError representa un error cuando se deben agrupar varios errores en un solo error. Se lanza cuando una operación necesita informar de varios errores, por ejemplo, Promise.any(), cuando todas las promesas que se le pasan son rechazadas.
Constructor
AggregateError()-
Crea un nuevo objeto
AggregateError.
Propiedades de la instancia
AggregateError.prototype.message-
Mensaje de error, el valor predeterminado es
""(la cadena vacía). AggregateError.prototype.name-
Nombre del error, el valor predeterminado es
AggregateError.
Ejemplos
Capturar un error agregado
js
Promise.any([Promise.reject(new Error("algún error"))]).catch((e) => {
console.log(e instanceof AggregateError); // true
console.log(e.message); // "Todas las promesas rechazadas"
console.log(e.name); // "AggregateError"
console.log(e.errors); // [ Error: "algún error" ]
});
Crear un AggregateError
js
try {
throw new AggregateError([new Error("algún error")], "Hola");
} catch (e) {
console.log(e instanceof AggregateError); // true
console.log(e.message); // "Hola"
console.log(e.name); // "AggregateError"
console.log(e.errors); // [ Error: "algún error" ]
}
Especificaciones
| Especificación |
|---|
| ECMAScript® 2027 Language Specification # sec-aggregate-error-objects |