Error - JavaScript | MDN

Toggle sidebar

Theme

OS default
Light
Dark

Português (do Brasil)

Remember language Learn more

Error

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 construtor de Error cria um objeto de erro. Instâncias de objetos Error são lançadas quando erros de tempo de execução ocorrem. O objeto Error também pode ser usado como objeto base para exceções definidas pelo usuário. Veja abaixo tipos de erro padrões embutidos.

Sintaxe

new Error([message[, fileName[, lineNumber]]])

Parâmetros

message

Opcional. Descrição do erro legível para humanos.

fileName

Opcional. O valor da propriedade fileName no objeto de erro criado. O padrão é o nome do arquivo contendo o código que chamou o construtor de Error().

lineNumber

Opcional. O valor da propriedade lineNumber no objeto de Error criado. O padrão é o número da linha contendo a invocação do construtor Error().

Descrição

Erros em tempo de execução resultam em novos objetos Error sendo criados e lançados.

Esta página documenta o uso do objeto Error em si e seu uso como uma função construtora. Para uma lista de propriedades e métodos herdados por instâncias de Error, veja Error.prototype.

Tipos de erro

Além do construtor genérico de Error, existem outros seis construtores principais de erro no JavaScript. Para exceções em client-side, veja Exceções na captura de Instruções.

EvalError

Cria uma instância representando um erro que ocorre na função global. eval().

InternalError

Cria uma instância representando um erro que ocorre quando um erro interno na engine do JavaScript é lançado. Ex: "too much recursion".

RangeError

Cria uma instância representando um erro que ocorre quando um valor ou parâmetro numérico está fora de seus limites válidos.

ReferenceError

Cria uma instância representando um erro que ocorre ao de-referenciar uma referência inválida.

SyntaxError

Cria uma instância representando um erro que ocorre ao fazer o parse do código em eval().

TypeError

Cria uma instância representando um erro que ocorre quando uma variável ou parâmetro não é de um tipo válido.

URIError

Cria uma instância representando um erro que ocorre quando são passados parâmetros inválidos para encodeURI() ou decodeURI().

Propriedades

Error.prototype

Permite a criação de propriedades para instâncias de Error.

Métodos

O objeto Error global não contém métodos próprios, entretanto, ele herda alguns métodos através da cadeia de prototypes.

Instâncias de Error

Propriedades

Métodos

Exemplos

Lançando um erro genérico

Geralmente você cria um objeto Error com a intenção de lançá-lo usando a palavra-chave throw. Você pode capturar o erro usando uma construção de try...catch:

js
try {
  throw new Error("Oooops!");
} catch (e) {
  alert(e.name + ": " + e.message);
}

Capturando um erro específico

Você pode escolher por capturar apenas tipos de erro específicos testando o tipo do erro com a propriedade constructor de erro ou, se você está escrevendo para engines de JavaScript modernas, a palavra-chave instanceof:

js
try {
  Objeto.Metodo();
} catch (e) {
  if (e instanceof EvalError) {
    alert(e.name + ": " + e.message);
  } else if (e instanceof RangeError) {
    alert(e.name + ": " + e.message);
  }
  // ... etc
}

Tipos de erro customizados

Você pode escolher definir seus próprios tipos de erro derivando de Error para conseguir usar throw new MeuErro() e usar instanceof MeuErro para checar o tipo de erro na captura da exceção. A forma comum para isso está demonstrada abaixo

Aviso: Note que as instâncias MeuErro lançadas vão reportar valores de lineNumber e fileName incorretos, ao menos no Firefox.

Veja também "esta discussão no Stackoverflow (em inglês): What's a good way to extend Error in JavaScript?".

js
// Cria um novo objeto que herda o construtor de Error através do prototype.
function MeuErro(message) {
  this.name = "MeuErro";
  this.message = message || "Mensagem de erro padrão";
  this.stack = new Error().stack;
}
MeuErro.prototype = Object.create(MeuErro.prototype);
MeuErro.prototype.constructor = MeuErro;

try {
  throw new MeuErro();
} catch (e) {
  console.log(e.name); // 'MeuErro'
  console.log(e.message); // 'Mensagem de erro padrão'
}

try {
  throw new MeuErro("Mensagem customizada");
} catch (e) {
  console.log(e.name); // 'MeuErro'
  console.log(e.message); // 'Mensagem customizada'
}

Help improve MDN

Was this page helpful to you?

Yes No

Learn how to contribute

This page was last modified on 17 de dez. de 2024 by MDN contributors.

View this page on GitHub • Report a problem with this content

Objetos Globais
Error
Construtor
1. Error()
Métodos estáticos
1. captureStackTrace()
2. isError()
Propriedades estáticas
1. stackTraceLimit
Métodos de instância
1. Error.prototype.toString()
Propriedades de instância
1. Error.prototype.cause
2. columnNumber
3. fileName
4. lineNumber
5. Error.prototype.message
6. Error.prototype.name
7. stack
Herança
Object/Function
Métodos estáticos
1. Function.prototype.apply()
2. Function.prototype.bind()
3. Function.prototype.call()
4. Function.prototype.toString()
5. [Symbol.hasInstance]()
Propriedades estáticas
1. Function.displayName
2. Function.length
3. Function.name
4. prototype
5. Function.arguments
6. Function.caller
Métodos de instância
1. Object.prototype.__defineGetter__()
2. Object.prototype.__defineSetter__()
3. Object.prototype.__lookupGetter__()
4. Object.prototype.__lookupSetter__()
5. Object.prototype.hasOwnProperty()
6. Object.prototype.isPrototypeOf()
7. Object.prototype.propertyIsEnumerable()
8. Object.prototype.toLocaleString()
9. Object.prototype.toString()
10. Object.prototype.valueOf()
Propriedades de instância
1. Object.prototype.__proto__
2. Object.prototype.constructor
Páginas relacionadas
AggregateError
EvalError
InternalError
RangeError
ReferenceError
SyntaxError
TypeError
URIError

Error

In this article

Sintaxe

Parâmetros

Descrição

Tipos de erro

Propriedades

Métodos

Instâncias de Error

Propriedades

Métodos

Exemplos

Lançando um erro genérico

Capturando um erro específico

Tipos de erro customizados

Especificações

Compatibilidade com navegadores

Veja também

Help improve MDN