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

CKTIS / JavaScript

ReferenceError — невалидни препратки към променливи

ReferenceError е вграден тип грешка в JavaScript, който се задейства, наред с други случаи, при прочитане на неразрешено име или променлива преди инициализацията ѝ. Научете как липсващата променлива се различава от undefined и защо typeof не заобикаля правилата за инициализация.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

new ReferenceError(message)
ReferenceError(message)

ReferenceError е вграден тип грешка в ECMAScript, който наследява Error; той не е Web API. Енджинът го задейства, наред с други случаи, когато прочитаният идентификатор не съответства на достъпно обвързване, например заради печатна грешка или употреба на име извън обхвата му. Декларирана и инициализирана променлива със стойност undefined не е същото като липсващо обвързване.

Прочитането на променлива, декларирана с let или const, преди инициализацията ѝ също задейства ReferenceError. Този период се нарича temporal dead zone (TDZ). Операторът typeof връща "undefined" за неразрешено име, но не заобикаля TDZ: typeof value преди инициализацията на локално let value задейства грешка. За разлика от това, обикновеното прочитане на липсващо свойство на обикновен обект връща undefined, а не ReferenceError.

new ReferenceError(message) създава обект за грешка; разрешено е и извикването ReferenceError(message) без new. Аргументът message не е задължителен. Създаването на обекта не задейства грешката — за това е необходим throw. Използвайте try...catch за обработка на очаквани грешки, но отстранявайте печатните грешки и неправилния ред на инициализация при източника им. Точната формулировка на съобщенията, генерирани от енджина, може да се различава между реализациите.

Примери

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

Резултат

true
ReferenceError
Missing binding

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

Източници