CKTIS / JavaScript
ErrorEvent.error ed ErrorEvent.message: valore e messaggio di errore
`message` contiene il testo diagnostico dell’evento, mentre `error` contiene il valore JavaScript associato, che non deve essere per forza un oggetto `Error`.
Versione: ECMAScript 2024 and the current web platform; runtime support varies
Sintassi
new ErrorEvent(type)
new ErrorEvent(type, { message, error })
event.message
event.errorErrorEvent è un’interfaccia della piattaforma web, non un tipo integrato in ECMAScript 2024. Su un’istanza, event.message restituisce una stringa che descrive il problema e event.error il valore JavaScript associato. Entrambe le proprietà sono di sola lettura. error può contenere un oggetto Error, un valore primitivo come 0, null o undefined. Non dare per scontato che il valore abbia un proprio messaggio o una traccia dello stack.
new ErrorEvent(type, options) inizializza le due proprietà separatamente. Secondo lo standard HTML, se ometti message, il valore predefinito è ""; se ometti error, è undefined. Se il valore fornito è un oggetto Error, event.error.message appartiene a quell’oggetto e non deve per forza coincidere con event.message.
Quando il browser segnala sulla finestra un’eccezione non intercettata di uno script, un listener registrato con window.addEventListener("error", handler) riceve un solo ErrorEvent. Per lo stesso evento, window.onerror riceve cinque argomenti posizionali: (message, source, lineno, colno, error). Non tutti gli eventi error sono ErrorEvent: il mancato caricamento di una risorsa su un elemento non garantisce queste proprietà. Il browser può segnalare il rifiuto non gestito di una promessa tramite un evento separato, unhandledrejection, con la proprietà reason. Non invia l’evento se gli errori dello script sono nascosti o se il rifiuto viene gestito prima della notifica.
Se i dettagli dell’errore di uno script classico vengono nascosti, come può succedere con uno script di un’altra origine caricato senza CORS, il rapporto contiene "Script error." in message e null in error. Usa il testo per la diagnosi, non come codice di errore stabile. Fuori dal browser, verifica se l’ambiente di esecuzione rende disponibile ErrorEvent.
Esempi
{
// 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);
}Risultato
Validation failed true Invalid input
Esegui il codice in Node.js 24 o nella console di un browser. Se `ErrorEvent` non è disponibile nativamente, l’esempio usa un sostituto locale che riproduce solo le due proprietà mostrate. Il codice crea un evento sintetico senza lanciare eccezioni né inviare l’evento. `true` conferma che si tratta dello stesso oggetto; la prima e l’ultima riga mostrano messaggi diversi.
Lezioni correlate
- JavaScript · Lezione 23 · Avanzato · Versione: 4