CKTIS / JavaScript
ReferenceError — riferimenti a variabili non validi
ReferenceError è un tipo di errore JavaScript integrato che viene generato, tra gli altri casi, quando si legge un nome non risolto o una variabile prima della sua inizializzazione. Scopri in che modo una variabile mancante differisce da undefined e perché typeof non aggira le regole di inizializzazione.
Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintassi
new ReferenceError(message)
ReferenceError(message)ReferenceError è un tipo di errore ECMAScript integrato che eredita da Error; non è una Web API. Il motore lo genera, tra gli altri casi, quando un identificatore letto non corrisponde a un binding accessibile, ad esempio a causa di un refuso o dell’uso di un nome al di fuori del suo ambito. Una variabile dichiarata e inizializzata il cui valore è undefined non equivale a un binding mancante.
La lettura di una variabile dichiarata con let o const prima della sua inizializzazione genera anch’essa un ReferenceError. Questo intervallo è chiamato temporal dead zone (TDZ). L’operatore typeof restituisce "undefined" per un nome non risolto, ma non aggira la TDZ: typeof value prima dell’inizializzazione di un let value locale genera un errore. Al contrario, la normale lettura di una proprietà mancante su un oggetto ordinario restituisce undefined, non ReferenceError.
new ReferenceError(message) crea un oggetto errore; è consentito anche chiamare ReferenceError(message) senza new. L’argomento message è facoltativo. Creare l’oggetto non genera l’errore: per farlo serve throw. Usa try...catch per gestire gli errori previsti, ma correggi all’origine i refusi e l’ordine di inizializzazione errato. La formulazione esatta dei messaggi generati dal motore può variare tra le implementazioni.
Esempi
(() => {
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);
})();Risultato
true ReferenceError Missing binding
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.