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

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

Fuentes