验证器

一个Sumor Cloud工具。
更多文档

这是一个轻量级的用于 Node.JS 的验证器。
它可以根据您定义的规则验证输入的字符串或数字。

安装

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: '需要包含 demo',
      LENGTH_GREATER_THAN_5: '长度应大于 5'
    },
    'zh-TW': {
      ONLY_CHAR_DIGIT: '只允许输入字母和数字',
      INCLUDE_DEMO: '需要包含 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) // [ '只允许输入字母和数字', '需要包含 demo', '长度应大于 5' ]

// 翻译成繁体中文
const messages7 = validate(parameterInfo, 'de', 'zh-TW')
console.log(messages7) // [ '只允许输入字母和数字', '需要包含 demo', '长度应大于 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' ]

格式化字符串用法

Trim 用法

将去除前缀和后缀的冗余空格

import { format } from '@sumor/validator'

const parameterInfo = {
  type: 'string',
  trim: true // 字符串类型默认为 true
}

const value = format(parameterInfo, ' demo ')
console.log(value) // 输出 "demo"，将去除冗余空格

Lowercase 用法

将字符串转换为小写

import { format } from '@sumor/validator'

const parameterInfo = {
  type: 'string',
  lowercase: true
}

const value = format(parameterInfo, 'Demo')
console.log(value) // 输出 "demo"，将所有字符转换为小写

Uppercase 用法

将字符串转换为大写

import { format } from '@sumor/validator'

const parameterInfo = {
  type: 'string',
  uppercase: true
}

const value = format(parameterInfo, 'Demo')
console.log(value) // 输出 "DEMO"，将所有字符转换为大写

格式化数字用法

import { format } from '@sumor/validator'

const parameterInfo = {
  type: 'number',
  decimal: 2
}

const value1 = format(parameterInfo, 1.234)
console.log(value1) // 输出 1.23，仅保留 2 位小数

const value2 = format(parameterInfo, '1.234')
console.log(value2) // 将转换为数字 1.23，仅保留 2 位小数

启用输出错误

如果您传递 error:true，响应将是 SumorError 对象。
您可以通过 @sumor/error 支持更改语言并导出 json。

import { validate } from '@sumor/validator'

const parameterInfo = {
  error: true,
  type: 'string',
  required: true,
  length: 10,
  rule: [
    {
      code: 'LENGTH_GREATER_THAN_5',
      expression: value => {
        return value.length > 5
      },
      message: '长度应大于 5'
    }
  ]
}

const messages = validate(parameterInfo, 'demo123456', 'en', true)
console.log(messages)
/* 
SumorError
{
  code: 'LENGTH_GREATER_THAN_5',
  message: '长度应大于 5'
}
*/