CKTIS / JavaScript
ReferenceError — ungültige Variablenreferenzen
ReferenceError ist ein integrierter JavaScript-Fehlertyp, der unter anderem ausgelöst wird, wenn ein nicht auflösbarer Name oder eine Variable vor ihrer Initialisierung gelesen wird. Erfahre, wie sich eine fehlende Variable von undefined unterscheidet und warum typeof die Initialisierungsregeln nicht umgeht.
Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
new ReferenceError(message)
ReferenceError(message)ReferenceError ist ein integrierter ECMAScript-Fehlertyp, der von Error erbt und keine Web-API ist. Die Engine löst ihn unter anderem aus, wenn sich ein gelesener Bezeichner nicht zu einer zugänglichen Bindung auflösen lässt, etwa aufgrund eines Tippfehlers oder wenn ein Name außerhalb seines Gültigkeitsbereichs verwendet wird. Eine deklarierte und initialisierte Variable mit dem Wert undefined ist nicht dasselbe wie eine fehlende Bindung.
Wird eine mit let oder const deklarierte Variable vor ihrer Initialisierung gelesen, wird ebenfalls ein ReferenceError ausgelöst. Dieser Zeitraum heißt temporal dead zone (TDZ). Der typeof-Operator gibt für einen nicht auflösbaren Namen "undefined" zurück, umgeht aber nicht die TDZ: typeof value vor der Initialisierung eines lokalen let value löst einen Fehler aus. Ein gewöhnlicher Lesezugriff auf eine fehlende Eigenschaft eines gewöhnlichen Objekts gibt dagegen undefined zurück, nicht ReferenceError.
new ReferenceError(message) erstellt ein Fehlerobjekt; auch der Aufruf ReferenceError(message) ohne new ist zulässig. Das Argument message ist optional. Das Erstellen des Objekts löst den Fehler nicht aus — dafür ist throw erforderlich. Verwende try...catch, um erwartete Fehler zu behandeln, aber behebe Tippfehler und eine falsche Initialisierungsreihenfolge an ihrer Ursache. Der genaue Wortlaut von durch die Engine erzeugten Meldungen kann sich je nach Implementierung unterscheiden.
Beispiele
(() => {
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);
})();Ergebnis
true ReferenceError Missing binding
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.