CKTIS / JavaScript
ErrorEvent — opis napake in povezana vrednost
ErrorEvent je vmesnik spletnega API-ja, ki opisuje napake v skriptih ali datotekah. Njegova lastnost message zagotavlja besedilni opis, medtem ko error vsebuje povezano vrednost JavaScripta, ki ni nujno objekt Error.
Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
new ErrorEvent(type, { message, error });
event.message;
event.error;ErrorEvent predstavlja dogodek z informacijami o napaki v skriptu ali datoteki. Deduje od Event in je na voljo tudi v Web Workers. Gre za vmesnik spletnega API-ja, opredeljen v standardu HTML, ne pa za vgrajeni objekt ECMAScript. To, da projekt uporablja Node 24, ne dokazuje, da brskalnik podpira ta API.
ErrorEvent.message je lastnost samo za branje, ki vrne človeku berljiv opis napake kot niz. Tudi ErrorEvent.error je samo za branje, vendar vrne povezano vrednost JavaScripta. To je lahko Error ali DOMException, vendar ne predpostavljaj te vrste: pred dostopom do lastnosti, značilnih za napake, preveri vrednost in njeno vrsto.
new ErrorEvent(type, { message, error }) ustvari dogodek z ločeno podanim opisom in vrednostjo napake. event.message ni nujno enak event.error.message. Primer namenoma poda različna niza, primerjava === pa pokaže, da se error sklicuje na isti objekt kot cause. Že samo ustvarjanje dogodka ne sproži izjeme in dogodka ne pošlje poslušalcem.
Primeri
(() => {
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);
})();Rezultat
Validation failed true Invalid input
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.