에러

Sumor Cloud 도구입니다.
더 많은 문서 에서 확인하세요. 다국어 지원, 사전 정의된 오류 코드, 데이터 전달을 지원하는 오류 처리 라이브러리입니다.

CI Test Coverage Audit

설치

npm i @sumor/error --save

전제 조건

Node.JS 버전

Node.JS 버전 16.x 이상이 필요합니다.

Node.JS ES 모듈 필요

이 패키지는 ES 모듈로 작성되었으므로, package.json 파일에서 다음 코드를 변경해주세요:

{
  "type": "module"
}

사용 방법

오류 정의

import defineError from '@sumor/error'

const MyError = defineError({
  code: {
    USER_NOT_FOUND: '사용자를 찾을 수 없습니다.',
    USER_EXISTED: '{name} 사용자가 이미 있습니다.'
  }
})

throw new MyError('USER_NOT_FOUND')
// 출력: Error: 사용자를 찾을 수 없습니다.

throw new MyError('USER_EXISTED', { name: 'Alice' })
// 출력: Error: Alice 사용자가 이미 있습니다.

다국어

import defineError from '@sumor/error'

const MyError = defineError({
  language: 'en', // 기본 언어
  code: {
    USER_NOT_FOUND: 'User not found',
    USER_EXISTED: 'User {name} existed'
  },
  i18n: {
    zh: {
      USER_NOT_FOUND: '사용자를 찾을 수 없습니다.',
      USER_EXISTED: '{name} 사용자가 이미 있습니다.'
    }
  }
})

const error = new MyError('USER_EXISTED', { name: 'Alice' })
error.language = 'en' // 오류 언어 변경
console.log(error)
// 출력: Error: Alice 사용자가 이미 있습니다.

error.language = 'zh' // 오류 언어 변경
console.log(error)
// 출력: Error: Alice 사용자가 이미 있습니다.

JSON으로 오류 변환

import defineError from '@sumor/error'

const MyError = defineError({
  code: {
    USER_NOT_FOUND: '사용자 찾을 수 없음',
    USER_EXISTED: '{name} 사용자가 이미 있음'
  }
})

const error = new MyError('USER_EXISTED', { name: 'Alice' })
console.log(error.json())
// 출력: {"code":"USER_EXISTED","message":"Alice 사용자가 이미 있음"}

하부 오류

import defineError from '@sumor/error'

const MyError = defineError({
  code: {
    FIELD_VERIFY_FAILED: '필드 검증 실패',
    FIELD_CANNOT_EMPTY: '{name} 필드는 비워둘 수 없음',
    FIELD_TOO_LONG: '{name} 필드가 너무 김'
  },
  i18n: {
    zh: {
      FIELD_VERIFY_FAILED: '필드 검증 실패',
      FIELD_CANNOT_EMPTY: '{name} 필드는 비워둘 수 없음',
      FIELD_TOO_LONG: '{name} 필드가 너무 김'
    }
  }
})

const error = new MyError('FIELD_VERIFY_FAILED', {}, [
  new MyError('FIELD_CANNOT_EMPTY', { name: 'username' }),
  new MyError('FIELD_TOO_LONG', { name: 'password' })
])

console.log(error.json())
/* 
출력: 
{
  "code":"FIELD_VERIFY_FAILED",
  "message":"필드 검증 실패",
  "errors":[
    {
      "code":"FIELD_CANNOT_EMPTY",
      "message":"username 필드는 비워둘 수 없음"
    },{
      "code":"FIELD_TOO_LONG",
      "message":"password 필드가 너무 김"
    }
  ]
}
*/

error.language = 'zh'
console.log(error.json())
/*
출력:
{
  "code":"FIELD_VERIFY_FAILED",
  "message":"필드 검증 실패",
  "errors":[
    {
      "code":"FIELD_CANNOT_EMPTY",
      "message":"username 필드는 비워둘 수 없음"
    },{
      "code":"FIELD_TOO_LONG",
      "message":"password 필드가 너무 김"
    }
  ]
}
*/

표준 오류 결합

import defineError from '@sumor/error'

const MyError = defineError({
  code: {
    FIELD_VERIFY_FAILED: '필드 검증 실패',
    FIELD_CANNOT_EMPTY: '{name} 필드는 비워둘 수 없음',
    FIELD_TOO_LONG: '{name} 필드가 너무 김'
  }
})

const error = new MyError('FIELD_VERIFY_FAILED', {}, [
  new MyError('FIELD_CANNOT_EMPTY', { name: 'username' }),
  new MyError('FIELD_TOO_LONG', { name: 'password' }),
  new Error('알 수 없는 오류')
])

console.log(error.json())
/*
출력:
{
  "code":"FIELD_VERIFY_FAILED",
  "message":"필드 검증 실패",
  "errors":[
    {
      "code":"FIELD_CANNOT_EMPTY",
      "message":"username 필드는 비워둘 수 없음"
    },{
      "code":"FIELD_TOO_LONG",
      "message":"password 필드가 너무 김"
    },{
      "code":"UNKNOWN_ERROR",
      "message":"알 수 없는 오류"
    }
  ]
}
 */