CKTIS / JavaScript
ReferenceError — ongeldige verwijzingen naar variabelen
ReferenceError is een ingebouwd JavaScript-fouttype dat onder andere wordt veroorzaakt wanneer je een niet-opgeloste naam of een variabele vóór initialisatie uitleest. Ontdek hoe een ontbrekende variabele verschilt van undefined en waarom typeof de initialisatieregels niet omzeilt.
Versie: 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 is een ingebouwd ECMAScript-fouttype dat erft van Error; het is geen Web-API. De engine veroorzaakt deze fout onder andere wanneer een gelezen identifier niet kan worden gekoppeld aan een toegankelijke binding, bijvoorbeeld door een typefout of doordat een naam buiten het bereik wordt gebruikt. Een gedeclareerde en geïnitialiseerde variabele met de waarde undefined is niet hetzelfde als een ontbrekende binding.
Het uitlezen van een met let of const gedeclareerde variabele vóór de initialisatie veroorzaakt ook een ReferenceError. Deze periode heet de temporal dead zone (TDZ). De operator typeof geeft "undefined" terug voor een niet-opgeloste naam, maar omzeilt de TDZ niet: typeof value vóór de initialisatie van een lokale let value veroorzaakt een fout. Een gewone uitlezing van een ontbrekende eigenschap van een gewoon object geeft daarentegen undefined terug, geen ReferenceError.
new ReferenceError(message) maakt een foutobject; ook de aanroep ReferenceError(message) zonder new is toegestaan. Het argument message is optioneel. Het object maken veroorzaakt de fout niet — daarvoor is throw nodig. Gebruik try...catch om verwachte fouten af te handelen, maar herstel typefouten en een onjuiste initialisatievolgorde bij de bron. De precieze tekst van door de engine gegenereerde meldingen kan per implementatie verschillen.
Voorbeelden
(() => {
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);
})();Resultaat
true ReferenceError Missing binding
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.