Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

Nombres de errores: Error.prototype.name

La propiedad name de un objeto de error describe su categoría, como Error o TypeError. Se puede sobrescribir, pero cambiar el nombre no cambia el tipo del objeto ni su cadena de prototipos.

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

error.name
error.name = "CustomError"

La etiqueta Error.name se refiere aquí al nombre de una instancia de error: se lee como error.name. La propiedad está definida en Error.prototype con el valor inicial "Error". Tipos como TypeError proporcionan sus propios nombres en sus prototipos. Sin embargo, la expresión literal Error.name lee el nombre de la función constructora: es una propiedad distinta.

name identifica la categoría, mientras que message describe el problema concreto. Error.prototype.toString() utiliza ambas propiedades; cuando ambas son cadenas no vacías, el resultado es "name: message".

Error.prototype.name es escribible, no enumerable y configurable. Asignar error.name = "ValidationError" a una instancia ordinaria crea una propiedad propia. No crea un nuevo tipo de error ni cambia la cadena de prototipos: el objeto sigue cumpliendo error instanceof Error. Por tanto, el nombre por sí solo no demuestra el tipo de un objeto.

Ejemplos

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

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.

Fuentes