@sumor/validator

Validador

Una herramienta de Sumor Cloud.
Más documentación

Este es un validador ligero para Node.JS. Puede validar la cadena de entrada o el número basado en las reglas que hayas definido.

CI Test Coverage Audit

Instalación

npm i @sumor/validator --save

Prerrequisitos

Versión de Node.JS

Requiere Node.JS versión 16.x o superior

Requiere módulo ES de Node.JS

Dado que este paquete está escrito en módulo ES, por favor cambia el siguiente código en tu archivo package.json:

{
  "type": "module"
}

Uso

Uso de Validación de Cadenas

import { validate } from '@sumor/validator'

const infoParametro = {
  type: 'string',
  required: true,
  length: 10,
  rule: [
    // solo permite a-z, A-Z, 0-9
    {
      id: 'ONLY_CHAR_DIGIT',
      expression: '^[a-zA-Z0-9]*$',
      message: 'solo permite a-z, A-Z, 0-9'
    },
    // debe incluir demo
    {
      id: 'INCLUDE_DEMO',
      expression: 'demo',
      message: 'debe incluir demo'
    },
    // usar función para comprobar
    {
      id: 'LENGTH_GREATER_THAN_5',
      expression: value => {
        return value.length > 5
      },
      message: 'la longitud debe ser mayor de 5'
    }
  ],
  i18n: {
    zh: {
      ONLY_CHAR_DIGIT: 'solo permite letras y números',
      INCLUDE_DEMO: 'debe incluir demo',
      LENGTH_GREATER_THAN_5: 'la longitud debe ser mayor de 5'
    },
    'zh-TW': {
      ONLY_CHAR_DIGIT: 'solo permite letras y números',
      INCLUDE_DEMO: 'debe incluir demo',
      LENGTH_GREATER_THAN_5: 'la longitud debe ser mayor de 5'
    }
  }
}

const mensajes1 = validate(infoParametro, 'demo123456')
console.log(mensajes1) // []

const mensajes2 = validate(infoParametro, 'de1234567')
console.log(mensajes2) // [ 'solo permite a-z, A-Z, 0-9' ]

const mensajes3 = validate(infoParametro, 'demo!')
console.log(mensajes3) // [ 'solo permite a-z, A-Z, 0-9', 'debe incluir demo' ]

const mensajes4 = validate(infoParametro, 'de!mo')
console.log(mensajes4) // [ 'solo permite a-z, A-Z, 0-9', 'debe incluir demo' ]

const mensajes5 = validate(infoParametro, 'de')
console.log(mensajes5) // [ 'solo permite a-z, A-Z, 0-9', 'debe incluir demo', 'la longitud debe ser mayor de 5' ]

// traducir a zh
const mensajes6 = validate(infoParametro, 'de', 'zh')
console.log(mensajes6) // [ 'solo permite letras y números', 'debe incluir demo', 'la longitud debe ser mayor de 5' ]

// traducir a zh-TW
const mensajes7 = validate(infoParametro, 'de', 'zh-TW')
console.log(mensajes7) // [ 'solo permite letras y números', 'debe incluir demo', 'la longitud debe ser mayor de 5' ]

Uso de Validación de Números

import { validate } from '@sumor/validator'

const infoParametro = {
  type: 'number',
  required: true,
  rule: [
    // debe ser mayor de 5
    {
      id: 'GREATER_THAN_5',
      expression: value => {
        return value > 5
      },
      message: 'el valor debe ser mayor de 5'
    }
  ],
  i18n: {
    zh: {
      GREATER_THAN_5: 'el valor debe ser mayor de 5'
    },
    'zh-TW': {
      GREATER_THAN_5: 'el valor debe ser mayor de 5'
    }
  }
}

const mensajes1 = validate(infoParametro, 6)
console.log(mensajes1) // []

const mensajes2 = validate(infoParametro, 5)
console.log(mensajes2) // [ 'el valor debe ser mayor de 5' ]

const mensajes3 = validate(infoParametro, 4)
console.log(mensajes3) // [ 'el valor debe ser mayor de 5' ]

// traducir a zh
const mensajes4 = validate(infoParametro, 4, 'zh')
console.log(mensajes4) // [ 'el valor debe ser mayor de 5' ]

// traducir a zh-TW
const mensajes5 = validate(infoParametro, 4, 'zh-TW')
console.log(mensajes5) // [ 'el valor debe ser mayor de 5' ]

Uso de Formateo de Cadenas

import { format } from '@sumor/validator'

const infoParametro = {
  type: 'string'
}

const valor1 = format(infoParametro, ' demo ')
console.log(valor1) // imprimirá "demo", se eliminará el espacio innecesario

Uso de Formateo de Números

import { format } from '@sumor/validator'

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

const valor1 = format(infoParametro, 1.234)
console.log(valor1) // imprimirá 1.23, manteniendo solo 2 decimales

const valor2 = format(infoParametro, '1.234')
console.log(valor2) // se convertirá a número 1.23, manteniendo solo 2 decimales