CKTIS / JavaScript
Error.message — el texto del mensaje de error
La propiedad message de una instancia de Error contiene el texto del mensaje sin el nombre del error. Aprende en qué se diferencian error.message y error.toString(), y qué ocurre cuando se omite el mensaje.
Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxis
const error = new Error(message);
error.messageError.message se refiere aquí a la propiedad message de una instancia de error, a la que se accede como error.message, y no a una propiedad estática del constructor Error. Forma parte de ECMAScript, no de una API web.
Al llamar a new Error(message) con un argumento distinto de undefined, el constructor aplica la operación ToString. Solo si la conversión tiene éxito almacena el resultado en una propiedad message propia, no enumerable, escribible y configurable. Por ejemplo, new Error(Symbol()) lanza un TypeError durante la conversión, por lo que la llamada no devuelve ninguna instancia. Si se omite el argumento o su valor es undefined, el constructor no crea una propiedad message propia; si el prototipo no se ha modificado, al leerla se obtiene la propiedad heredada Error.prototype.message, cuyo valor inicial es la cadena vacía "".
error.message contiene solo el mensaje. En cambio, para un Error normal con un mensaje no vacío, error.toString() combina el nombre y el mensaje en la forma Error: Invalid input. Si el mensaje está vacío, devuelve únicamente el nombre Error.
Para que los ejemplos sean predecibles, proporciona tu propio mensaje, como en el ejemplo siguiente. No bases la lógica del programa en el texto exacto de los mensajes generados por el motor: puede variar entre implementaciones.
Ejemplos
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 ""
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.