Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

ErrorEvent.error i ErrorEvent.message: wartość błędu a komunikat

`message` to tekst diagnostyczny zdarzenia, a `error` to powiązana wartość JavaScript. Nie musi to być obiekt `Error`.

Wersja: ECMAScript 2024 and the current web platform; runtime support varies

Składnia

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

ErrorEvent jest interfejsem platformy webowej, a nie wbudowanym typem ECMAScript 2024. Na instancji zdarzenia event.message zwraca napis opisujący problem, a event.error — powiązaną wartość JavaScript. Obie właściwości są tylko do odczytu. Wartość error może być obiektem Error, wartością prymitywną, taką jak 0, albo null lub undefined. Nie zakładaj, że ma własny komunikat lub stos wywołań.

Konstruktor new ErrorEvent(type, options) ustawia te właściwości niezależnie. Zgodnie ze standardem HTML pominięte message ma wartość "", a pominięte error — undefined. Jeśli przekazana wartość jest obiektem Error, event.error.message należy do tego obiektu i nie musi być równe event.message.

Gdy przeglądarka zgłasza w oknie nieprzechwycony wyjątek skryptu, funkcja przekazana do window.addEventListener("error", handler) otrzymuje jeden obiekt ErrorEvent. Dla tego samego zdarzenia window.onerror otrzymuje pięć argumentów pozycyjnych: (message, source, lineno, colno, error). Nie każde zdarzenie error jest obiektem ErrorEvent: błąd ładowania zasobu na elemencie nie gwarantuje tych właściwości. Przeglądarka może zgłosić nieobsłużone odrzucenie obietnicy przez osobne zdarzenie unhandledrejection z właściwością reason. Nie wysyła tego zdarzenia, jeśli błędy skryptu są wyciszone lub odrzucenie zostanie obsłużone przed zgłoszeniem.

Jeśli przeglądarka ukrywa szczegóły błędu klasycznego skryptu, na przykład skryptu z innego źródła załadowanego bez CORS, raport zawiera message o wartości "Script error." i error o wartości null. Traktuj komunikat jako tekst diagnostyczny, a nie stabilny kod błędu. Poza przeglądarką sprawdź, czy środowisko udostępnia ErrorEvent.

Przykłady

{
  // Use the native constructor when available; otherwise model only these two properties.
  const ErrorEvent = globalThis.ErrorEvent ?? class extends Event {
    #message;
    #error;

    constructor(type, { message = "", error } = {}) {
      super(type);
      this.#message = String(message);
      this.#error = error;
    }

    get message() { return this.#message; }
    get error() { return this.#error; }
  };

  const original = new Error("Invalid input");
  const event = new ErrorEvent("error", {
    message: "Validation failed",
    error: original,
  });

  console.log(event.message);
  console.log(event.error === original);
  console.log(event.error.message);
}

Wynik

Validation failed
true
Invalid input

Uruchom kod w Node.js 24 lub w konsoli przeglądarki. Jeśli środowisko nie udostępnia natywnego `ErrorEvent`, przykład używa lokalnego zamiennika odtwarzającego tylko te dwie właściwości. Kod tworzy zdarzenie syntetyczne bez rzucania wyjątku ani wysyłania zdarzenia. Wynik `true` potwierdza, że zdarzenie przechowuje ten sam obiekt; pierwsza i ostatnia linia pokazują dwa różne komunikaty.

Powiązane lekcje

  • JavaScript · Lekcja 23 · Zaawansowany · Wersja: 4

Źródła