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

CKTIS / JavaScript

ErrorEvent.error y ErrorEvent.message: valor de error y mensaje

`message` contiene el texto de diagnóstico del evento y `error` el valor de JavaScript asociado, que no tiene por qué ser un objeto `Error`.

Versión: ECMAScript 2024 and the current web platform; runtime support varies

Sintaxis

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

ErrorEvent es una interfaz de la plataforma web, no un tipo incorporado en ECMAScript 2024. En una instancia, event.message devuelve una cadena que describe el problema y event.error devuelve el valor de JavaScript asociado. Ambas propiedades son de solo lectura. error puede contener un objeto Error, un valor primitivo como 0, null o undefined. No des por hecho que el valor tenga un mensaje propio o una traza de pila.

new ErrorEvent(type, options) inicializa las dos propiedades por separado. Según el estándar HTML, si omites message, su valor predeterminado es ""; si omites error, es undefined. Si el valor suministrado es un objeto Error, event.error.message pertenece a ese objeto y no tiene por qué coincidir con event.message.

Cuando el navegador notifica en la ventana una excepción de script no capturada, un listener registrado con window.addEventListener("error", handler) recibe un único ErrorEvent. Para el mismo evento, window.onerror recibe cinco argumentos posicionales: (message, source, lineno, colno, error). No todo evento error es un ErrorEvent: un fallo de carga de un recurso en un elemento no garantiza estas propiedades. El navegador puede notificar un rechazo de promesa no gestionado mediante un evento distinto, unhandledrejection, con la propiedad reason. No despacha ese evento si los errores del script están silenciados o si el rechazo se gestiona antes de la notificación.

Si se ocultan los detalles del error de un script clásico, como puede ocurrir con un script de otro origen cargado sin CORS, el informe contiene "Script error." en message y null en error. Usa el texto para diagnosticar, no como código de error estable. Fuera del navegador, comprueba si el entorno de ejecución ofrece ErrorEvent.

Ejemplos

{
  // Use the native constructor when available; otherwise model only these two properties.
  const ErrorEvent = globalThis.ErrorEvent ?? class extends Event {
    #message;
    #error;

    constructor(type, { message = "", error } = {}) {
      super(type);
      this.#message = String(message);
      this.#error = error;
    }

    get message() { return this.#message; }
    get error() { return this.#error; }
  };

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

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

Resultado

Validation failed
true
Invalid input

Ejecuta el código en Node.js 24 o en la consola de un navegador. Si no hay un `ErrorEvent` nativo, el ejemplo usa un sustituto local que solo reproduce las dos propiedades mostradas. El código crea un evento sintético sin lanzar ninguna excepción ni despachar el evento. `true` confirma que se trata del mismo objeto; la primera y la última línea muestran mensajes distintos.

Lecciones relacionadas

  • JavaScript · Lección 23 · Avanzado · Versión: 4

Fuentes