Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

ReferenceError — błąd odwołania do zmiennej

ReferenceError to wbudowany typ błędu JavaScript zgłaszanego między innymi przy odczycie nierozpoznanej nazwy lub zmiennej przed jej inicjalizacją. Poznaj różnicę między brakiem zmiennej a wartością undefined oraz ograniczenie operatora typeof.

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 ReferenceError(message)
ReferenceError(message)

ReferenceError jest wbudowanym typem błędu ECMAScript, dziedziczącym po Error, a nie interfejsem Web API. Silnik zgłasza go między innymi wtedy, gdy odczytywany identyfikator nie wskazuje żadnego dostępnego wiązania, na przykład wskutek literówki lub użycia nazwy poza jej zakresem. Zadeklarowana i zainicjalizowana zmienna o wartości undefined nie jest tym samym co brak wiązania.

Odczyt zmiennej zadeklarowanej przez let lub const przed jej inicjalizacją również zgłasza ReferenceError. Ten okres nazywa się temporal dead zone (TDZ). Operator typeof zwraca "undefined" dla nierozpoznanej nazwy, ale nie omija TDZ: typeof value przed inicjalizacją lokalnego let value zgłasza błąd. Zwykły odczyt brakującej właściwości zwykłego obiektu zwraca natomiast undefined, a nie ReferenceError.

new ReferenceError(message) tworzy obiekt błędu; wywołanie ReferenceError(message) bez new także jest dozwolone. Argument message jest opcjonalny. Samo utworzenie obiektu nie zgłasza wyjątku — wymaga to throw. Używaj try...catch do obsługi oczekiwanych błędów, ale literówki i błędną kolejność inicjalizacji poprawiaj u źródła. Dokładna treść komunikatu generowanego przez silnik może się różnić między implementacjami.

Przykłady

(() => {
  try {
    console.log(typeof value);
    let value = 42;
  } catch (error) {
    console.log(error instanceof ReferenceError);
    console.log(error.name);
  }

  const custom = new ReferenceError("Missing binding");
  console.log(custom.message);
})();

Wynik

true
ReferenceError
Missing binding

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

Źródła