CKTIS / JavaScript
Error.message — o texto da mensagem de erro
A propriedade message de uma instância Error contém o texto da mensagem sem o nome do erro. Saiba em que diferem error.message e error.toString() e o que acontece quando a mensagem é omitida.
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
const error = new Error(message);
error.messageError.message refere-se aqui à propriedade message de uma instância de erro, acedida como error.message, e não a uma propriedade estática do construtor Error. Faz parte do ECMAScript, não de uma Web API.
Quando se chama new Error(message) com um argumento diferente de undefined, o construtor aplica a operação ToString. Só se a conversão for bem-sucedida é que guarda o resultado numa propriedade message própria, não enumerável, gravável e configurável. Por exemplo, new Error(Symbol()) lança um TypeError durante a conversão, pelo que a chamada não devolve nenhuma instância. Se o argumento for omitido ou for undefined, o construtor não cria uma propriedade message própria; se o protótipo não tiver sido alterado, a leitura devolve a propriedade herdada Error.prototype.message, cujo valor inicial é a cadeia vazia "".
error.message contém apenas a mensagem. Em contrapartida, para um Error normal com uma mensagem não vazia, error.toString() combina o nome e a mensagem sob a forma Error: Invalid input. Quando a mensagem está vazia, devolve apenas o nome Error.
Para obter exemplos previsíveis, indique uma mensagem sua, como no exemplo abaixo. Não baseie a lógica do programa no texto exato das mensagens geradas pelo motor: o texto pode variar entre implementações.
Exemplos
const error = new Error("Invalid input");
console.log(error.message);
console.log(error.toString());
console.log(JSON.stringify(new Error().message));Resultado
Invalid input Error: Invalid input ""
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.