Error.prototype.cause

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since setembro de 2021.

A propriedade cause indica a causa original específica de um erro.

É usado quando captura e relança um erro com uma mensagem mais específica ou útil para ter acesso ao erro original.

Valor

Este é o valor que foi passado para o construtor Error() no argumento options.cause.

O valor pode ser de qualquer tipo. Você não deve criar suposições que o erro que você apanhou tem um Error como sua cause, e da mesma forma você não pode ter certeza que a variável vinculada na declaração catch e um Error qualquer. O exemplo abaixo "Forncenendo dados estruturados é a causa do erro" mostra uma casa onde um não erro é deliberadamente fornecido como causa

Exemplos

Relançando um erro com a causa

Isso é útil algumas vezes para capturar um erro e relançá-lo com uma nova mensagem. E nesse caso você deve passar o erro original no construtor para o novo Error aparecer.

js
try {
  connectToDatabase();
} catch (err) {
  throw new Error("Falha na comunicação com o banco de dados.", { cause: err });
}

Para exemplos mais detalhados veja Erro > Diferenciar entre erros semelhantes.

Fornecendo dados estruturados como a causa de erro

Mensagens de erro escritas para o humano consumir pode ser inapropriado para a análise de máquina, já que estão sujetos a mudanças de reformulação ou pontuação ele pode parar qualquer análise de escrita existente para consumi-los. Então quando um erro é disparado de uma função, é uma alternativa para a leitura humana da mensagem de erro, você pode em vez disso fornecer a causa com dados estruturados, para análise de máquina.

js
function makeRSA(p, q) {
  if (!Number.isInteger(p) || !Number.isInteger(q)) {
    throw new Error("RSA key generation requires integer inputs.", {
      cause: { code: "NonInteger", value: [p, q] },
    });
  }
  if (!areCoprime(p, q)) {
    throw new Error("RSA key generation requires two co-prime integers.", {
      cause: { code: "NonCoprime", values: [p, q] },
    });
  }
  // rsa algorithm…
}

Help improve MDN

Was this page helpful to you?

Yes No

Learn how to contribute

This page was last modified on 4 de nov. de 2022 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.prototype.cause

In this article

Valor

Exemplos

Relançando um erro com a causa

Fornecendo dados estruturados como a causa de erro

Especificações

Compatibilidade com navegadores

Veja também

Help improve MDN