JavaScript의 기본 Error 객체

Error() constructor - JavaScript | MDN

TL;DR

자바스크립트에 내장된 기본 Error 객체는 name, message 파라미터를 받는다

에러를 반환할 때 호출되는 toString 메소드는 name이 존재하지 않을 경우 "Error: "와 message를 붙여서 반환하게 된다.

일반적인 에러 관리법

보통 에러를 반환할 때는, 기본 에러 타입을 상속받아서 커스텀한 메시지를 반환하는 형태를 이용합니다.

interface HttpError {  
    status?: number;  
    message?: string;
    code?: number;  
}  

interface HttpErrors {  
    errors: HttpError[];  
}
  
declare class HttpException extends Error {  
    status: number;  
    message: string;  
    errors: HttpError | HttpErrors;  
    constructor(status: number, message: string, code?: number, errors?: any);  
    json(): HttpError | HttpErrors;  
}
  
export default HttpException;

export class CustomException extends HttpException {  
  constructor(message: string = "Someting text…") {  
    super(HttpStatusCode.SERVER_ERROR_500, message);  
    this.name = "CustomException";  
  }}	
}	

 

커스텀 메시지  

어떠한 에러가 발생했는지에 대한 내용을 표현하는 message에는 클라이언트와 협의하여 방식을 채택하고 있습니다.

1. 서버에서 반환한 메시지를 그대로 보여주거나
2. 사전에 협의한 code 값으로 프론트에서 처리하거나
3. 2번과 같이 한다면 message는 디버깅용에 사용하곤 합니다.

정리하는 이유

문제가 되었던 부분은 다음과 같습니다,

Error: 서버에 문제가 발생했습니다. 관리자에게 문의해주세요.

기획에서는 ”Error:“ 텍스트를 요청한 적이 없었고, 코드 에디터에서 별도로 해당 텍스트를 검색해봐도 작성한 부분이 없었습니다.

20.5.3.3 Error.prototype.name

ECMAScript® 2025 Language Specification

명세에 따르면 name이 없으면 초기 값은 “Error”라고 명시되어 있습니다.
9번에 따르면 콜론과 스페이스를 덧붙이는 것을 알 수 있습니다.

명세서에는 코드가 나와있지 않지만 위 명세를 예시로 들면 아래와 같습니다.

Error.prototype.toString = function() {
    let name = this.name !== undefined ? String(this.name) : "Error";
    let msg = this.message !== undefined ? String(this.message) : "";
    if (name === "") return msg;
    if (msg === "") return name;
    return `${name}: ${msg}`;
};

몰랐던 부분에 대해서 정리합니다.