no-validate v1.0.3

noV

使用Proxy实现的优雅的、流畅的校验系统，目前已应用在百万DAU的线上产品中。

安装

npm install --dev-save no-validate

使用

import noV from 'no-validate';

noV().maxLength().test(myValue);

验证表单最常见的邮箱、手机号码：

noV().email().test(myEmail);

noV().phoneNumber().test(myPhone);

或许你还想要验证用户设置的密码是否符合你的规则，假设我们规定密码的规则是长度为至少为6位，并且至少包含数字和字母 那么我们可以使用类似链式一样的操作（但是实际上，只有我们调用了test方法后，校验阶段才会开始）

noV().minLength(6).pattern(/[a-z]?[0-9]+[a-z]+/i).test(password)

或许有时候你还想取反其中的某个验证规则，这个时候你可以使用 not 这个修饰符：

noV().not.range(5,7).test(myStr)

这个时候意味着 myStr 的长度小于5或者大于7才会返回 true。

这当然还不够

如果你想要知道校验失败时具体是哪条规则没有通过，你可以使用 testPlus 方法，这个方法将会返回一个对象，包含result与step字段的对象

假如我们规定标题长度需要大于4个字符，并且最后必须要以问号结尾，我们可以使用 testPlus 方法来精确了解到我们的校验规则具体的执行结果：

const result = noV().minLength(5).pattern(/(\?|？)$/).testPlus(myTitle)

如果 myTitle 在第二个校验规则失败了，那么这个 result 对象将会是：

{
  result: false,
  step: 2
}

有了这个信息我们可以很方便地针对每一个校验失败进行特定的处理，最常见的就是告诉用户需要怎样修改：

const errors = [
  '请最少输入5个字符',
  '标题须以问号结尾'
]

modal.show(errors[result.step -1]);

为了更加方便一点，noV允许将这些额外的信息作为第二个参数传递给 testPlus 方法，如：

const result = noV().minLength(6).pattern(/[a-z]?[0-9]+[a-z]+/i).testplus(password, errors)

这样，result对象将会把这些额外的信息作为 info 字段的值：

{
  result: false,
  step: 2,
  info: '标题须以问号结尾'
}

我们需要知道的是，传递给 testPlus 方法的额外信息不仅仅可以数组，还可以是一个以 规则名 为key的对象，上面的等价于：

const errors = {
  minLength: '请最少输入5个字符',
  pattern: '标题须以问号结尾'
};

const result = noV().minLength(6).pattern(/[a-z]?[0-9]+[a-z]+/i).test(password, errors)

这样，如果你的校验规则需要经常修改，那么你也不会那么被动。

鉴于笔者目前的工作以及前端多端环境的复杂，nov 还提供了对于UA校验的规则，包括对 Android 、 IOS 、 微信、QQ环境的校验，这通常在你的应用需要对不同环境适配（如果你的应用使用了微信、或者QQ的js-SDK，这将非常有用），例如：

noV().uaIOS().test(navigator.userAgent);

noV().uaAndroid().test(navigator.userAgent);

noV().uaWX().test(navigator.userAgent);

noV().uaQQ().test(navigator.userAgent)

API

规则（Rule）

Type

Number

String

Array

Object

修饰符

校验