오류

Sumor Cloud 도구.
더 많은 문서 여러 언어를 지원하고 사전 정의된 오류 코드 및 데이터 전달을 지원하는 오류 처리 라이브러리.

설치

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({
  name: 'MyError',
  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({
  name: 'MyError',
  language: 'en', // 기본 언어
  code: {
    USER_NOT_FOUND: '사용자를 찾을 수 없음',
    USER_EXISTED: '{name} 사용자가 이미 존재함'
  },
  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({
  name: 'MyError',
  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({
  name: 'MyError',
  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({
  name: 'MyError',
  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":"알 수 없는 오류"
    }
  ]
}
 */