오류

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 not found',
    USER_EXISTED: 'User {name} existed'
  }
})

const error = new MyError('USER_EXISTED', { name: 'Alice' })
console.log(error.json())
// 출력: {"code":"USER_EXISTED","message":"User Alice existed"}

하위 오류

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":"알 수 없는 오류"
    }
  ]
}
 */