Esta página foi traduzida do inglês pela comunidade.Saiba mais e junte-se à comunidade MDN Web Docs.
ReferenceError
Baseline Widely available *
This feature is well established and works across many devices and browser versions. It’s been available across browsers since julho de 2015.
* Some parts of this feature may have varying levels of support.
O objetoReferenceError representa um erro quando uma variável não existente é referenciada.
Sintaxe
new ReferenceError([message[, fileName[, lineNumber]]])
Parâmetros
messageOpcional. Descrição legível do erro.
fileNameNão padrãoOpcional. O nome do arquivo contendo o código que causou a excessão.
lineNumberNão padrãoOpcional. O número da linha do código que causou a excessão.
Descrição
OReferenceError acontece quando é feita uma tentativa de referenciar uma variável que não foi declarada.
Propriedades
ReferenceError.prototypePermite a inclusão de propriedades em um objeto
ReferenceError.
Métodos
OReferenceError não contém métodos próprios, porém, ele herda alguns métodos através da cadeia de protótipos.
Instâncias doReferenceError
Propriedades
Métodos
Exemplos
Capturando umReferenceError
try { var a = variavelNaoDefinida;} catch (e) { console.log(e instanceof ReferenceError); // true console.log(e.message); // "variavelNaoDefinida não está definida" console.log(e.name); // "ReferenceError" console.log(e.fileName); // "Scratchpad/1" console.log(e.lineNumber); // 2 console.log(e.columnNumber); // 6 console.log(e.stack); // "@Scratchpad/2:2:7\n"}Criando umReferenceError
try { throw new ReferenceError("Olá", "arquivoQualquer.js", 10);} catch (e) { console.log(e instanceof ReferenceError); // true console.log(e.message); // "Olá" console.log(e.name); // "ReferenceError" console.log(e.fileName); // "arquivoQualquer.js" console.log(e.lineNumber); // 10 console.log(e.columnNumber); // 0 console.log(e.stack); // "@Scratchpad/2:2:9\n"}Especificações
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-native-error-types-used-in-this-standard-referenceerror |