CKTIS / JavaScript
ReferenceError — referências inválidas a variáveis
ReferenceError é um tipo de erro JavaScript integrado, gerado, entre outros casos, ao ler um nome não resolvido ou uma variável antes da sua inicialização. Saiba como uma variável inexistente difere de undefined e por que razão typeof não contorna as regras de inicialização.
Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxe
new ReferenceError(message)
ReferenceError(message)ReferenceError é um tipo de erro ECMAScript integrado que herda de Error; não é uma API Web. O motor gera-o, entre outros casos, quando um identificador que está a ser lido não corresponde a uma ligação acessível, por exemplo, devido a um erro de escrita ou à utilização de um nome fora do seu âmbito. Uma variável declarada e inicializada cujo valor é undefined não é o mesmo que uma ligação inexistente.
A leitura de uma variável declarada com let ou const antes da sua inicialização também gera um ReferenceError. Este intervalo chama-se temporal dead zone (TDZ). O operador typeof devolve "undefined" para um nome não resolvido, mas não contorna a TDZ: typeof value antes da inicialização de um let value local gera um erro. Em contrapartida, a leitura normal de uma propriedade inexistente num objeto normal devolve undefined, não ReferenceError.
new ReferenceError(message) cria um objeto de erro; também é permitido chamar ReferenceError(message) sem new. O argumento message é opcional. Criar o objeto não gera o erro — para isso é necessário throw. Utilize try...catch para tratar erros esperados, mas corrija na origem os erros de escrita e a ordem de inicialização incorreta. A formulação exata das mensagens geradas pelo motor pode variar entre implementações.
Exemplos
(() => {
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);
})();Resultado
true ReferenceError Missing binding
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.