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

CKTIS / JavaScript

Nomes de erros: Error.prototype.name

A propriedade name de um objeto de erro descreve a sua categoria, como Error ou TypeError. Pode ser substituída, mas alterar o nome não muda o tipo do objeto nem a sua cadeia de protótipos.

Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxe

error.name
error.name = "CustomError"

A entrada Error.name refere-se aqui ao nome de uma instância de erro: lê-se como error.name. A propriedade está definida em Error.prototype com o valor inicial "Error". Tipos como TypeError disponibilizam nomes próprios nos respetivos protótipos. Já a expressão literal Error.name lê o nome da função construtora — uma propriedade diferente.

name identifica a categoria, enquanto message descreve o problema específico. Error.prototype.toString() utiliza ambas as propriedades; quando ambas são cadeias não vazias, o resultado é "name: message".

Error.prototype.name é gravável, não enumerável e configurável. Atribuir error.name = "ValidationError" a uma instância comum cria uma propriedade própria. Não cria um novo tipo de erro nem altera a cadeia de protótipos: o objeto continua a satisfazer error instanceof Error. Por isso, o nome, por si só, não prova o tipo de um objeto.

Exemplos

const error = new Error("Invalid input");
console.log(error.name);
error.name = "ValidationError";
console.log(error.name);
console.log(error.message);
console.log(error.toString());
console.log(error instanceof Error);

Resultado

Error
ValidationError
Invalid input
ValidationError: Invalid input
true

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes