@sumor/validator

Валидатор

Инструмент Sumor Cloud.
Дополнительная документация

Это легкий валидатор для Node.JS. Он может проверить входную строку или число на основе заданных вами правил.

CI Test Coverage Audit

Установка

npm i @sumor/validator --save

Пререквизиты

Версия Node.JS

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

Требование к модулю Node.JS ES

Поскольку этот пакет написан в ES-модуле, пожалуйста, измените следующий код в вашем файле package.json:

{
  "type": "module"
}

Использование

Использование валидации строк

import { validate } from '@sumor/validator'

const parameterInfo = {
  type: 'string',
  required: true,
  length: 10,
  rule: [
    // разрешить только a-z, A-Z, 0-9
    {
      code: 'ONLY_CHAR_DIGIT',
      expression: '^[a-zA-Z0-9]*$',
      message: 'только a-z, A-Z, 0-9 разрешены'
    },
    // нужно включить demo
    {
      code: 'INCLUDE_DEMO',
      expression: 'demo',
      message: 'необходимо включить demo'
    },
    // использование функции для проверки
    {
      code: 'LENGTH_GREATER_THAN_5',
      expression: value => {
        return value.length > 5
      },
      message: 'длина должна быть больше 5'
    }
  ],
  i18n: {
    zh: {
      ONLY_CHAR_DIGIT: 'только ввод букв и цифр',
      INCLUDE_DEMO: 'необходимо включить демо',
      LENGTH_GREATER_THAN_5: 'длина должна быть больше 5'
    },
    'zh-TW': {
      ONLY_CHAR_DIGIT: 'только ввод букв и цифр',
      INCLUDE_DEMO: 'необходимо включить демо',
      LENGTH_GREATER_THAN_5: 'длина должна быть больше 5'
    }
  }
}

const messages1 = validate(parameterInfo, 'demo123456')
console.log(messages1) // []

const messages2 = validate(parameterInfo, 'de1234567')
console.log(messages2) // [ 'только a-z, A-Z, 0-9 разрешены' ]

const messages3 = validate(parameterInfo, 'demo!')
console.log(messages3) // [ 'только a-z, A-Z, 0-9 разрешены', 'необходимо включить demo' ]

const messages4 = validate(parameterInfo, 'de!mo')
console.log(messages4) // [ 'только a-z, A-Z, 0-9 разрешены', 'необходимо включить demo' ]

const messages5 = validate(parameterInfo, 'de')
console.log(messages5) // [ 'только a-z, A-Z, 0-9 разрешены', 'необходимо включить demo', 'длина должна быть больше 5' ]

// перевести на китайский
const messages6 = validate(parameterInfo, 'de', 'zh')
console.log(messages6) // [ 'только ввод букв и цифр', 'необходимо включить демо', 'длина должна быть больше 5' ]

// перевести на традиционный китайский
const messages7 = validate(parameterInfo, 'de', 'zh-TW')
console.log(messages7) // [ 'только ввод букв и цифр', 'необходимо включить демо', 'длина должна быть больше 5' ]

Использование валидации чисел

import { validate } from '@sumor/validator'

const parameterInfo = {
  type: 'number',
  required: true,
  rule: [
    // нужно больше 5
    {
      code: 'GREATER_THAN_5',
      expression: value => {
        return value > 5
      },
      message: 'значение должно быть больше 5'
    }
  ],
  i18n: {
    zh: {
      GREATER_THAN_5: 'значение должно быть больше 5'
    },
    'zh-TW': {
      GREATER_THAN_5: 'значение должно быть больше 5'
    }
  }
}

const messages1 = validate(parameterInfo, 6)
console.log(messages1) // []

const messages2 = validate(parameterInfo, 5)
console.log(messages2) // [ 'значение должно быть больше 5' ]

const messages3 = validate(parameterInfo, 4)
console.log(messages3) // [ 'значение должно быть больше 5' ]

// перевести на китайский
const messages4 = validate(parameterInfo, 4, 'zh')
console.log(messages4) // [ 'значение должно быть больше 5' ]

// перевести на традиционный китайский
const messages5 = validate(parameterInfo, 4, 'zh-TW')
console.log(messages5) // [ 'значение должно быть больше 5' ]