Saltar al contenido principal
Version: 0.2.0-beta.1

Clase: MCPAuthError

Clase base para todos los errores de mcp-auth.

Proporciona una forma estandarizada de manejar errores relacionados con la Autenticación (Authentication) y Autorización (Authorization) de MCP.

Hereda de​

  • Error

Extendida por​

Constructores​

Constructor​

new MCPAuthError(code: string, message: string): MCPAuthError;

Parámetros​

code​

string

El código de error en formato snake_case.

message​

string

Una descripción legible para humanos del error.

Devuelve​

MCPAuthError

Sobrescribe​

Error.constructor

Propiedades​

cause?​

optional cause: unknown;

Heredado de​

Error.cause

code​

readonly code: string;

El código de error en formato snake_case.

message​

message: string;

Heredado de​

Error.message

name​

name: string = 'MCPAuthError';

Sobrescribe​

Error.name

stack?​

optional stack: string;

Heredado de​

Error.stack

stackTraceLimit​

static stackTraceLimit: number;

La propiedad Error.stackTraceLimit especifica el número de marcos de pila recopilados por un seguimiento de pila (ya sea generado por new Error().stack o Error.captureStackTrace(obj)).

El valor predeterminado es 10, pero puede establecerse en cualquier número válido de JavaScript. Los cambios afectarán a cualquier seguimiento de pila capturado después de que se haya cambiado el valor.

Si se establece en un valor que no es un número, o en un número negativo, los seguimientos de pila no capturarán ningún marco.

Heredado de​

Error.stackTraceLimit

Métodos​

toJson()​

toJson(showCause: boolean): Record<string, unknown>;

Convierte el error a un formato JSON amigable para respuestas HTTP.

Parámetros​

showCause​

boolean = false

Indica si se debe incluir la causa del error en la respuesta JSON. Por defecto es false.

Devuelve​

Record<string, unknown>

captureStackTrace()​

static captureStackTrace(targetObject: object, constructorOpt?: Function): void;

Crea una propiedad .stack en targetObject, que al accederse devuelve una cadena que representa la ubicación en el código en la que se llamó a Error.captureStackTrace().

const myObject = {};
Error.captureStackTrace(myObject);
myObject.stack;  // Similar a `new Error().stack`

La primera línea del seguimiento estará precedida por ${myObject.name}: ${myObject.message}.

El argumento opcional constructorOpt acepta una función. Si se proporciona, todos los marcos por encima de constructorOpt, incluido constructorOpt, se omitirán del seguimiento de pila generado.

El argumento constructorOpt es útil para ocultar detalles de implementación de la generación de errores al usuario. Por ejemplo:

function a() {
  b();
}

function b() {
  c();
}

function c() {
  // Crear un error sin seguimiento de pila para evitar calcular el seguimiento dos veces.
  const { stackTraceLimit } = Error;
  Error.stackTraceLimit = 0;
  const error = new Error();
  Error.stackTraceLimit = stackTraceLimit;

  // Capturar el seguimiento de pila por encima de la función b
  Error.captureStackTrace(error, b); // Ni la función c ni b se incluyen en el seguimiento de pila
  throw error;
}

a();

Parámetros​

targetObject​

object

constructorOpt?​

Function

Devuelve​

void

Heredado de​

Error.captureStackTrace

prepareStackTrace()​

static prepareStackTrace(err: Error, stackTraces: CallSite[]): any;

Parámetros​

err​

Error

stackTraces​

CallSite[]

Devuelve​

any

Ver​

https://v8.dev/docs/stack-trace-api#customizing-stack-traces

Heredado de​

Error.prepareStackTrace