Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

ErrorEvent — descripción del error y valor asociado

ErrorEvent es una interfaz de la API Web que describe errores en scripts o archivos. Su propiedad message proporciona una descripción textual, mientras que error contiene el valor de JavaScript asociado, que no tiene por qué ser un objeto Error.

Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxis

new ErrorEvent(type, { message, error });
event.message;
event.error;

ErrorEvent representa un evento que contiene información sobre un error en un script o archivo. Hereda de Event y también está disponible en Web Workers. Es una interfaz de la API Web definida por el estándar HTML, no un objeto integrado de ECMAScript. Que un proyecto use Node 24 no demuestra que esta API sea compatible con el navegador.

ErrorEvent.message es una propiedad de solo lectura que devuelve una descripción del error en forma de cadena, legible para las personas. ErrorEvent.error también es de solo lectura, pero devuelve el valor de JavaScript asociado. Puede ser un Error o un DOMException, pero no des por sentado ese tipo: comprueba el valor y su tipo antes de acceder a propiedades específicas de los errores.

new ErrorEvent(type, { message, error }) crea un evento con una descripción y un valor de error proporcionados por separado. event.message no tiene por qué ser igual a event.error.message. El ejemplo proporciona deliberadamente cadenas distintas, y la comparación === muestra que error hace referencia al mismo objeto que cause. Crear el evento no lanza una excepción ni lo envía a los listeners.

Ejemplos

(() => {
  const cause = new Error("Invalid input");
  const event = new ErrorEvent("error", {
    message: "Validation failed",
    error: cause,
  });

  console.log(event.message);
  console.log(event.error === cause);
  console.log(event.error.message);
})();

Resultado

Validation failed
true
Invalid input

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes