База знанияИзпитен център
BGБългарски
Избери език13

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници