CKTIS / JavaScript
ErrorEvent.error a ErrorEvent.message: hodnota chyby a chybová zpráva
`message` obsahuje diagnostický text události, zatímco `error` obsahuje přidruženou hodnotu JavaScriptu, která nemusí být objektem `Error`.
Verze: ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
new ErrorEvent(type)
new ErrorEvent(type, { message, error })
event.message
event.errorErrorEvent je rozhraní webové platformy, nikoli vestavěný typ ECMAScriptu 2024. Na instanci event.message vrací řetězec popisující problém a event.error přidruženou hodnotu JavaScriptu. Obě vlastnosti jsou pouze pro čtení. error může obsahovat objekt Error, primitivní hodnotu jako 0, null nebo undefined. Nepředpokládejte, že má tato hodnota vlastní zprávu nebo výpis zásobníku volání.
new ErrorEvent(type, options) inicializuje obě vlastnosti nezávisle. Podle standardu HTML má vynechané message výchozí hodnotu "" a vynechané error hodnotu undefined. Je-li předanou hodnotou objekt Error, patří event.error.message tomuto objektu a nemusí se shodovat s event.message.
Když prohlížeč na okně nahlásí nezachycenou výjimku skriptu, posluchač registrovaný pomocí window.addEventListener("error", handler) dostane jediný objekt ErrorEvent. Pro stejnou událost dostane window.onerror pět pozičních argumentů: (message, source, lineno, colno, error). Ne každá událost error je typu ErrorEvent: při selhání načítání zdroje na prvku nejsou tyto vlastnosti zaručeny. Neošetřené zamítnutí příslibu může prohlížeč nahlásit samostatnou událostí unhandledrejection s vlastností reason. Tuto událost nevyvolá, pokud jsou chyby skriptu potlačeny nebo pokud je zamítnutí ošetřeno před nahlášením.
Pokud jsou podrobnosti chyby klasického skriptu skryté, například u skriptu z jiného původu načteného bez CORS, hlášení má message nastavené na "Script error." a error na null. Text zprávy používejte k diagnostice, ne jako stabilní kód chyby. Mimo prohlížeč ověřte, zda běhové prostředí poskytuje ErrorEvent.
Příklady
{
// 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);
}Výsledek
Validation failed true Invalid input
Spusťte kód v Node.js 24 nebo v konzoli prohlížeče. Pokud prostředí neposkytuje nativní `ErrorEvent`, příklad použije lokální náhradu, která napodobuje pouze obě uvedené vlastnosti. Kód vytvoří syntetickou událost, aniž by vyvolal výjimku nebo událost odeslal. Řádek `true` potvrzuje totožnost objektu; první a poslední řádek ukazují různé zprávy.
Související lekce
- JavaScript · Lekce 23 · Pokročilá · Verze: 4