CKTIS / JavaScript
ReferenceError — neplatné odkazy na proměnné
ReferenceError je vestavěný typ chyby JavaScriptu, který se vyvolá mimo jiné při čtení nevyřešeného názvu nebo proměnné před její inicializací. Zjistěte, jak se chybějící proměnná liší od undefined a proč typeof neobchází pravidla inicializace.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
new ReferenceError(message)
ReferenceError(message)ReferenceError je vestavěný typ chyby ECMAScriptu, který dědí z Error; nejde o Web API. JavaScriptový engine jej vyvolá mimo jiné tehdy, když čtený identifikátor neodkazuje na žádnou dostupnou vazbu, například kvůli překlepu nebo použití názvu mimo jeho rozsah platnosti. Deklarovaná a inicializovaná proměnná s hodnotou undefined není totéž co chybějící vazba.
Čtení proměnné deklarované pomocí let nebo const před její inicializací také vyvolá ReferenceError. Toto období se nazývá temporal dead zone (TDZ). Operátor typeof vrací pro nevyřešený název "undefined", ale TDZ neobchází: typeof value před inicializací lokálního let value vyvolá chybu. Obyčejné čtení chybějící vlastnosti běžného objektu naproti tomu vrací undefined, nikoli ReferenceError.
new ReferenceError(message) vytvoří objekt chyby; je povoleno také volání ReferenceError(message) bez new. Argument message je nepovinný. Vytvoření objektu chybu nevyvolá — k tomu je potřeba throw. Očekávané chyby řešte pomocí try...catch, ale překlepy a nesprávné pořadí inicializace opravte přímo u zdroje. Přesné znění chybových zpráv, které engine vytváří, se může mezi implementacemi lišit.
Příklady
(() => {
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);
})();Výsledek
true ReferenceError Missing binding
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.