AggregateError

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 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

Specification
ECMAScript Language Specification
# sec-aggregate-error-objects

Compatibilidad con navegadores

BCD tables only load in the browser

Ve también