@sumor/validator

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만 허용
    {
      id: 'ONLY_CHAR_DIGIT',
      expression: '^[a-zA-Z0-9]*$',
      message: 'a-z, A-Z, 0-9만 허용'
    },
    // demo를 포함해야 함
    {
      id: 'INCLUDE_DEMO',
      expression: 'demo',
      message: 'demo를 포함해야 함'
    },
    // 함수를 사용하여 확인
    {
      id: '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보다 커야 함
    {
      id: '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자리만 유지됩니다