Ошибка

Инструмент Sumor Cloud.
Дополнительная документация Библиотека обработки ошибок поддерживает многоязычность, предопределенные коды ошибок и передачу данных.

CI Тест Покрытие Аудит

Установка

npm i @sumor/error --save

Предварительные требования

Версия Node.JS

Требуется версия Node.JS 16.x или выше

Требуется модуль ES Node.JS

Поскольку пакет написан на модуле 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_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({
  code: {
    USER_NOT_FOUND: 'Пользователь не найден',
    USER_EXISTED: 'Пользователь {name} существует'
  }
})

const error = new MyError('USER_EXISTED', { name: 'Alice' })
console.log(error.json())
// вывод: {"код":"USER_EXISTED","сообщение":"Пользователь 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())
/* 
вывод: 
{
  "код":"FIELD_VERIFY_FAILED",
  "сообщение":"Проверка поля не удалась",
  "ошибки":[
    {
      "код":"FIELD_CANNOT_EMPTY",
      "сообщение":"Поле username не может быть пустым"
    },{
      "код":"FIELD_TOO_LONG",
      "сообщение":"Поле password слишком длинное"
    }
  ]
}
*/

error.language = 'zh'
console.log(error.json())
/*
вывод:
{
  "код":"FIELD_VERIFY_FAILED",
  "сообщение":"Проверка поля не удалась",
  "ошибки":[
    {
      "код":"FIELD_CANNOT_EMPTY",
      "сообщение":"Поле username не может быть пустым"
    },{
      "код":"FIELD_TOO_LONG",
      "сообщение":"Поле 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())
/*
вывод:
{
  "код":"FIELD_VERIFY_FAILED",
  "сообщение":"Проверка поля не удалась",
  "ошибки":[
    {
      "код":"FIELD_CANNOT_EMPTY",
      "сообщение":"Поле username не может быть пустым"
    },{
      "код":"FIELD_TOO_LONG",
      "сообщение":"Поле password слишком длинное"
    },{
      "код":"UNKNOWN_ERROR",
      "сообщение":"Неизвестная ошибка"
    }
  ]
}
 */