Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes