Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

ErrorEvent — opis błędu i powiązana wartość

ErrorEvent to interfejs Web API opisujący błędy skryptów lub plików. Właściwość message udostępnia tekstowy opis, a error przechowuje powiązaną wartość JavaScript — niekoniecznie obiekt Error.

Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Składnia

new ErrorEvent(type, { message, error });
event.message;
event.error;

ErrorEvent reprezentuje zdarzenie zawierające informacje o błędzie skryptu lub pliku. Dziedziczy po Event i jest dostępny także w Web Workers. To interfejs Web API zdefiniowany w standardzie HTML, a nie wbudowany obiekt ECMAScript. Obecność Node 24 w projekcie nie potwierdza obsługi tego API w przeglądarce.

ErrorEvent.message jest właściwością tylko do odczytu, zwracającą zrozumiały dla człowieka opis błędu jako ciąg znaków. ErrorEvent.error również jest tylko do odczytu, ale zwraca powiązaną wartość JavaScript. Może to być Error lub DOMException, lecz nie należy zakładać takiego typu: przed odczytem właściwości charakterystycznych dla błędu sprawdź wartość i jej typ.

new ErrorEvent(type, { message, error }) pozwala utworzyć zdarzenie z osobno podanym opisem i wartością błędu. event.message nie musi być równe event.error.message. W przykładzie celowo podano różne teksty, a porównanie przez === pokazuje, że error wskazuje ten sam obiekt cause. Samo utworzenie zdarzenia nie rzuca wyjątku ani nie wysyła zdarzenia do odbiorców.

Przykłady

(() => {
  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);
})();

Wynik

Validation failed
true
Invalid input

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła