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