base-validator v1.0.1

base-validator

基础的表单验证器。用于 Browser 和 Node.js 环境下校验用户提交的数据。

Usage

npm i -S base-validator

const Validator = require('base-validator')
// 定义校验规则
const rule = [
    {
        prop: 'phone',
        msg: '手机号码不能为空',
        assert: 'required'
    }
]
// 待校验的数据
const form = {
    phone: ' 	' // 该值只包含空格和制表符，无法通过 required 校验
}

const msg = Validator(form, rule)
console(msg) // 手机号码不能为空

Validator(data, rule)

校验数据是否符合期望值。返回第一项不通过的项目的错误提示语 \<string>。全部通过时返回 undefined

• data \<object> 待校验的数据对象
• rule \<Arrayobject> 校验的规则，对象数组。
  • property \<string> 校验的字段名。Alias：prop、key
  • message \<string> 校验不通过时的提示语。Alias：msg
  • assert \<string> 校验的策略，支持的列表参考 Assert 表。
  • expected \<any> 期望值。部分校验策略需要带期望值。

Validator.all(data, rule)

同 Validator(data, rule) ，但返回全部不通过的项目。

Assert

Tips

在确保校验准确度的前提下，尽可能放宽规则。例：

• 符合数字格式的字符串或Number类型均可以通过 number 校验。

• 允许数据前后包含空白字符，用户可能不会注意到输入了空白字符。

• 0 和 false 出现在表单内，常作为 <input type="number" /> 和 <input type="checkbox" /> 的结果值。应当作有效值，可以通过 required 校验。
• 包含一个或多个空白字符的字符串，不包含任何可见字符，可能是用户无意中输入，但发现不到，这应当被 required 校验阻止。

Subset

Validator(data, rule) ，如果 data 对象没有 rule 中指定的属性，则不会提示，直接跳过。这样方便用一份 rule ，校验 data 的不同子集。是否有该属性用的是 Object.prototype.hasOwnProperty() 方法判断的。

// 定义全部校验规则
const RULE = [
    {
        prop: 'phone',
        assert: 'required',
        msg: '手机号码不能为空'
    },
    {
        prop: 'code',
        assert: 'required',
        msg: '验证码不能为空'
    }
]

let form = {
    phone: '13688888888',
    code: ''
}

// 发送验证码仅需要校验 phone 字段即可
function sendVerifyCode() {
    let { phone } = form
    // 校验部分字段
    let msg = Validator({ phone }, RULE)
    console.log(msg) // undefined
}

// 提交则需要校验 phone 字段和 code 字段
function submit() {
    let msg = Validator(form, RULE)
    console.log(msg) // 验证码不能为空
}