메인 콘텐츠로 건너뛰기
버전: 0.2.0-beta.1

클래스: MCPAuthError

모든 mcp-auth 오류의 기본 클래스입니다.

MCP 인증 (Authentication) 및 인가 (Authorization)와 관련된 오류를 표준화된 방식으로 처리할 수 있도록 합니다.

상속

  • Error

확장 클래스

생성자

생성자

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

매개변수

code

string

스네이크 케이스(snake_case) 형식의 오류 코드입니다.

message

string

오류에 대한 사람이 읽을 수 있는 설명입니다.

반환값

MCPAuthError

오버라이드

Error.constructor

프로퍼티

cause?

optional cause: unknown;

상속됨

Error.cause

code

readonly code: string;

스네이크 케이스(snake_case) 형식의 오류 코드입니다.


message

message: string;

상속됨

Error.message

name

name: string = 'MCPAuthError';

오버라이드

Error.name

stack?

optional stack: string;

상속됨

Error.stack

stackTraceLimit

static stackTraceLimit: number;

Error.stackTraceLimit 프로퍼티는 스택 트레이스( new Error().stack 또는 Error.captureStackTrace(obj)로 생성됨 )에서 수집되는 스택 프레임의 개수를 지정합니다.

기본값은 10이지만, 유효한 JavaScript 숫자로 설정할 수 있습니다. 값이 변경된 이후에 캡처되는 모든 스택 트레이스에 영향을 미칩니다.

숫자가 아닌 값이나 음수로 설정하면, 스택 트레이스는 프레임을 캡처하지 않습니다.

상속됨

Error.stackTraceLimit

메서드

toJson()

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

오류를 HTTP 응답에 적합한 JSON 형식으로 변환합니다.

매개변수

showCause

boolean = false

JSON 응답에 오류의 원인(cause)을 포함할지 여부입니다. 기본값은 false입니다.

반환값

Record<string, unknown>


captureStackTrace()

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

targetObject.stack 프로퍼티를 생성하며, 접근 시 Error.captureStackTrace()가 호출된 코드 위치를 나타내는 문자열을 반환합니다.

const myObject = {};
Error.captureStackTrace(myObject);
myObject.stack;  // `new Error().stack`과 유사

트레이스의 첫 번째 줄은 ${myObject.name}: ${myObject.message}로 시작합니다.

선택적 constructorOpt 인자는 함수입니다. 제공되면, constructorOpt를 포함하여 그 위의 모든 프레임이 생성된 스택 트레이스에서 생략됩니다.

constructorOpt 인자는 오류 생성의 구현 세부 정보를 사용자에게 숨기고 싶을 때 유용합니다. 예시:

function a() {
  b();
}

function b() {
  c();
}

function c() {
  // 스택 트레이스를 두 번 계산하지 않기 위해 스택 트레이스 없는 오류 생성
  const { stackTraceLimit } = Error;
  Error.stackTraceLimit = 0;
  const error = new Error();
  Error.stackTraceLimit = stackTraceLimit;

  // 함수 b 위에서 스택 트레이스 캡처
  Error.captureStackTrace(error, b); // 함수 c와 b는 스택 트레이스에 포함되지 않음
  throw error;
}

a();

매개변수

targetObject

object

constructorOpt?

Function

반환값

void

상속됨

Error.captureStackTrace

prepareStackTrace()

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

매개변수

err

Error

stackTraces

CallSite[]

반환값

any

참고

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

상속됨

Error.prepareStackTrace