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

CKTIS / JavaScript

Error: objeto de exceção base

Error cria o objeto de erro base com mensagem e causa opcionais, destinado a lançar e encadear falhas.

Versão: ECMAScript 1 onward; cause option from ECMAScript 2022; example target: Node.js 24.22.2

Sintaxe

Error(message?, options?); new Error(message?, options?)

new Error(message?, options?) cria um objeto de erro; chamar Error(...) sem new tem o mesmo efeito. Se message não for undefined, é convertido em string e guardado como propriedade própria message não enumerável. A propriedade herdada name é "Error" por omissão.

Se options for um objeto com propriedade cause, o valor é copiado sem conversão para uma propriedade própria cause não enumerável. Assim preserva-se a exceção original ao acrescentar contexto. A conversão da mensagem ou o getter cause pode lançar. Error pode ser subclassificado e instanceof Error reconhece instâncias normais.

stack é uma extensão útil do host, mas não padrão e de formato não portável. Para categorias próprias usa subclasses, não análise do texto de message. Error existe desde ECMAScript 1; a opção cause é padrão desde ECMAScript 2022.

Exemplos

function loadConfig() {
  try {
    JSON.parse("{");
  } catch (cause) {
    throw new Error("Could not load config", {cause});
  }
}

try {
  loadConfig();
} catch (error) {
  console.log(error.name, error.message);
  console.log(error.cause instanceof SyntaxError);
  console.log(Object.keys(error).join(",") || "(none)");
}
console.log(Error("plain") instanceof Error);

Resultado

Error Could not load config
true
(none)
true

Fontes