Error: cause

El valor que se pasó al constructor del Error() en el argumento options.cause. Puede no estar presente.

El valor de cause puede ser de cualquiér tipo. No debe suponer que el error que capturó tiene un Error como su cause, de la misma manera que no puede estar seguro que la variable enlazada en la instrucción catch sea un error tampoco. El siguiente ejemplo "Proporcionar datos estructurados como la causa del error" muestra un caso donde se proporciona deliberadamente un error como causa.

A veces es útil para detectar un error y volver a lanzarlo con un nuevo mensaje. En este caso debería pasar el error original al constructor para el nuevo Error, como se muestra.

try {
  connectToDatabase();
} catch (err) {
  throw new Error("Falló la conexión a la base de datos.", { cause: err });
}

Para un ejemplo mas detallado vea Error > Diferenciar entre errores similares.

Los mensajes de error escritos para consumo humano pueden ser inapropiados para el análisis de la máquina — dado que están sujetos a cambios de redacción o puntuación que pueden romper cualquier análisis existente escrito para consumirlos. Así que, cuando lanza un error de una función, como una alternativa a un mensaje de error legible por humanos, puede proporcionar la causa como datos estructurados, para el análisis de la máquina.

function makeRSA(p, q) {
  if (!Number.isInteger(p) || !Number.isInteger(q)) {
    throw new Error(
      "La generación de claves RSA requiere entradas de tipo entero.",
      {
        cause: { code: "NonInteger", values: [p, q] },
      },
    );
  }
  if (!areCoprime(p, q)) {
    throw new Error(
      "La generación de claves RSA requiere dos enteros coprimos.",
      {
        cause: { code: "NonCoprime", values: [p, q] },
      },
    );
  }
  // algoritmo rsa...
}

• Error.prototype.message
• Error.prototype.toString()