CKTIS / JavaScript
Error: objeto de excepción base
Error crea el objeto de error base con mensaje y causa opcionales, pensado para lanzar y encadenar fallos.
Versión: ECMAScript 1 onward; cause option from ECMAScript 2022; example target: Node.js 24.22.2
Sintaxis
Error(message?, options?); new Error(message?, options?)new Error(message?, options?) crea un objeto de error; llamar Error(...) sin new tiene el mismo efecto. Si message no es undefined, se convierte a string y se guarda como propiedad propia message no enumerable. La propiedad heredada name vale "Error" por defecto.
Si options es un objeto con propiedad cause, su valor se copia sin conversión a una propiedad propia cause no enumerable. Así se conserva la excepción original al añadir contexto. La conversión del mensaje o el getter cause pueden lanzar. Error admite subclases e instanceof Error reconoce instancias normales.
stack es una extensión útil del host, pero no estándar y de formato no portable. Para categorías propias usa subclases, no análisis del texto de message. Error existe desde ECMAScript 1; la opción cause es estándar desde ECMAScript 2022.
Ejemplos
function loadConfig() {
try {
JSON.parse("{");
} catch (cause) {
throw new Error("Could not load config", {cause});
}
}
try {
loadConfig();
} catch (error) {
console.log(error.name, error.message);
console.log(error.cause instanceof SyntaxError);
console.log(Object.keys(error).join(",") || "(none)");
}
console.log(Error("plain") instanceof Error);Resultado
Error Could not load config true (none) true