CKTIS / JavaScript
ErrorEvent — описание на грешка и свързана стойност
ErrorEvent е интерфейс на Web API, който описва грешки в скриптове или файлове. Свойството message предоставя текстово описание, а error съдържа свързаната JavaScript стойност, която не е задължително да бъде обект Error.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
new ErrorEvent(type, { message, error });
event.message;
event.error;ErrorEvent представлява събитие, съдържащо информация за грешка в скрипт или файл. Наследява Event и е достъпен и в Web Workers. Това е интерфейс на Web API, дефиниран от стандарта HTML, а не вграден обект на ECMAScript. Наличието на Node 24 в даден проект не доказва, че този API се поддържа в браузъра.
ErrorEvent.message е свойство само за четене, което връща разбираемо за хората описание на грешката като низ. ErrorEvent.error също е само за четене, но връща свързаната JavaScript стойност. Тя може да бъде Error или DOMException, но не приемайте този тип за даденост: проверете стойността и типа ѝ, преди да използвате свойства, специфични за грешки.
new ErrorEvent(type, { message, error }) създава събитие с отделно зададени описание и стойност на грешката. event.message не е задължително да е равно на event.error.message. Примерът умишлено задава различни низове, а сравнението === показва, че error сочи към същия обект като cause. Самото създаване на събитието нито хвърля изключение, нито изпраща събитието до слушатели.
Примери
(() => {
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);
})();Резултат
Validation failed true Invalid input
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.