CKTIS / JavaScript
ErrorEvent — popis chyby a související hodnota
ErrorEvent je rozhraní Web API, které popisuje chyby ve skriptech nebo souborech. Jeho vlastnost message poskytuje textový popis, zatímco error uchovává související hodnotu JavaScriptu, která nemusí být objektem Error.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
new ErrorEvent(type, { message, error });
event.message;
event.error;ErrorEvent představuje událost obsahující informace o chybě ve skriptu nebo souboru. Dědí z Event a je k dispozici také ve Web Workers. Jde o rozhraní Web API definované standardem HTML, nikoli o vestavěný objekt ECMAScriptu. To, že projekt používá Node 24, nedokazuje podporu tohoto API v prohlížeči.
ErrorEvent.message je vlastnost pouze pro čtení, která vrací lidsky čitelný popis chyby jako řetězec. Také ErrorEvent.error je pouze pro čtení, ale vrací související hodnotu JavaScriptu. Může jít o Error nebo DOMException, ale tento typ nepředpokládejte: před přístupem k vlastnostem specifickým pro chybu zkontrolujte hodnotu a její typ.
new ErrorEvent(type, { message, error }) vytvoří událost se samostatně zadaným popisem a hodnotou chyby. event.message se nemusí rovnat event.error.message. Příklad záměrně zadává různé řetězce a porovnání === ukazuje, že error odkazuje na stejný objekt jako cause. Pouhé vytvoření události nevyvolá výjimku ani událost neodesílá posluchačům.
Příklady
(() => {
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);
})();Výsledek
Validation failed true Invalid input
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.