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

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.message

Error.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.

Fontes