Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

ErrorEvent — descrizione dell’errore e valore associato

ErrorEvent è un’interfaccia della Web API che descrive gli errori negli script o nei file. La proprietà message fornisce una descrizione testuale, mentre error contiene il valore JavaScript associato, che non è necessariamente un oggetto Error.

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

Sintassi

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

ErrorEvent rappresenta un evento che contiene informazioni su un errore in uno script o in un file. Eredita da Event ed è disponibile anche nei Web Workers. È un’interfaccia della Web API definita dallo standard HTML, non un oggetto integrato di ECMAScript. La presenza di Node 24 in un progetto non dimostra che questa API sia supportata nel browser.

ErrorEvent.message è una proprietà di sola lettura che restituisce una descrizione dell’errore, leggibile da una persona, sotto forma di stringa. Anche ErrorEvent.error è di sola lettura, ma restituisce il valore JavaScript associato. Può essere un Error o una DOMException, ma non dare per scontato che sia di quel tipo: controlla il valore e il suo tipo prima di accedere alle proprietà specifiche degli errori.

new ErrorEvent(type, { message, error }) crea un evento con una descrizione e un valore di errore forniti separatamente. event.message non deve necessariamente essere uguale a event.error.message. L’esempio fornisce intenzionalmente stringhe diverse e il confronto === mostra che error fa riferimento allo stesso oggetto di cause. La semplice creazione dell’evento non genera un’eccezione e non invia l’evento ai listener.

Esempi

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

Risultato

Validation failed
true
Invalid input

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti