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.