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

CKTIS / JavaScript

ErrorEvent — descrição do erro e valor associado

ErrorEvent é uma interface da Web API que descreve erros em scripts ou ficheiros. A propriedade message fornece uma descrição textual, enquanto error contém o valor JavaScript associado, que não é necessariamente um objeto Error.

Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxe

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

ErrorEvent representa um evento que contém informações sobre um erro num script ou ficheiro. Herda de Event e também está disponível em Web Workers. É uma interface da Web API definida pela norma HTML, não um objeto integrado do ECMAScript. A presença do Node 24 num projeto não comprova que esta API seja suportada no navegador.

ErrorEvent.message é uma propriedade só de leitura que devolve uma descrição do erro, legível por uma pessoa, sob a forma de uma cadeia de caracteres. ErrorEvent.error também é só de leitura, mas devolve o valor JavaScript associado. Pode ser um Error ou uma DOMException, mas não pressuponhas que é desse tipo: verifica o valor e o respetivo tipo antes de aceder a propriedades específicas de erros.

new ErrorEvent(type, { message, error }) cria um evento com uma descrição e um valor de erro fornecidos separadamente. event.message não tem necessariamente de ser igual a event.error.message. O exemplo fornece deliberadamente cadeias diferentes, e a comparação === mostra que error se refere ao mesmo objeto que cause. A simples criação do evento não lança uma exceção nem envia o evento para os listeners.

Exemplos

(() => {
  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

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes