Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

ErrorEvent.error e ErrorEvent.message: valor de erro e mensagem

`message` contém o texto de diagnóstico do evento, enquanto `error` contém o valor JavaScript associado, que não tem de ser um objeto `Error`.

Versão: ECMAScript 2024 and the current web platform; runtime support varies

Sintaxe

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

ErrorEvent é uma interface da plataforma Web, não um tipo incorporado no ECMAScript 2024. Numa instância, event.message devolve uma cadeia de caracteres que descreve o problema e event.error devolve o valor JavaScript associado. Ambas as propriedades são só de leitura. error pode conter um objeto Error, um valor primitivo como 0, null ou undefined. Não pressuponhas que esse valor tem uma mensagem própria ou um rasto da pilha de chamadas.

new ErrorEvent(type, options) inicializa as duas propriedades de forma independente. Segundo a norma HTML, se omitires message, o valor predefinido é ""; se omitires error, é undefined. Se o valor fornecido for um objeto Error, event.error.message pertence a esse objeto e não tem de coincidir com event.message.

Quando o navegador comunica na janela uma exceção de script não capturada, um ouvinte registado com window.addEventListener("error", handler) recebe um único ErrorEvent. Para o mesmo evento, window.onerror recebe cinco argumentos posicionais: (message, source, lineno, colno, error). Nem todos os eventos error são ErrorEvent: uma falha no carregamento de um recurso num elemento não garante estas propriedades. O navegador pode comunicar uma rejeição de promessa não tratada através de um evento separado, unhandledrejection, com a propriedade reason. Não emite esse evento se os erros do script estiverem ocultos ou se a rejeição for tratada antes da notificação.

Se os detalhes do erro de um script clássico forem ocultados, como pode acontecer com um script de outra origem carregado sem CORS, o relatório contém "Script error." em message e null em error. Usa o texto para diagnóstico, não como código de erro estável. Fora do navegador, confirma se o ambiente de execução disponibiliza ErrorEvent.

Exemplos

{
  // 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

Executa o código em Node.js 24 ou na consola de um navegador. Se não houver um `ErrorEvent` nativo, o exemplo usa um substituto local que reproduz apenas as duas propriedades apresentadas. É criado um evento sintético sem lançar uma exceção nem enviar o evento. `true` confirma que se trata do mesmo objeto; a primeira e a última linha apresentam mensagens diferentes.

Lições relacionadas

  • JavaScript · Lição 23 · Avançado · Versão: 4

Fontes