返回：唐霜｜书

HelloType使用手册

完全符合ES语法的前端js运行时数据类型检查工具，从此对api返回的数据格式心中有数

前言

本项目不再维护，基于项目理念，我开发的【转载请注明来源】转载请注明出处：www.tangshuang.nettyshemo 更合理。请使用 tyshemo。
未经授权，禁止复制转载。【本文受版权保护】

HelloType是一款我想强推的前端数【版权所有，侵权必究】著作权归作者所有，禁止商业用途转载。据类型检查工具，因为越来越多的数据类型问本文版权归作者所有，未经授权不得转载。【关注微信公众号：wwwtangshuangnet】题引起了前端的bug。即使已经有Type未经授权，禁止复制转载。【原创不易，请尊重版权】Script、Flow等工具，但是还是无【版权所有，侵权必究】【作者：唐霜】法解决运行时的数据类型检查，它们都是在编著作权归作者所有，禁止商业用途转载。【版权所有】唐霜 www.tangshuang.net译时进行数据类型检查的工具。特别是在前端【作者：唐霜】转载请注明出处：www.tangshuang.net请求后端API，用返回的数据进行下一步操本文版权归作者所有，未经授权不得转载。【版权所有，侵权必究】作时，经常遇到由于前端默认认为后端返回的【版权所有】唐霜 www.tangshuang.net【原创不易，请尊重版权】数据格式是正确的，就直接进行一些数据遍历转载请注明出处：www.tangshuang.net著作权归作者所有，禁止商业用途转载。之类的操作，于是bug就出现了。

本文作者：唐霜，转载请注明出处。【转载请注明来源】本文作者：唐霜，转载请注明出处。

传统解决这类问题的办法是，在用到后端AP【版权所有】唐霜 www.tangshuang.net【本文受版权保护】I返回的数据之前，对要用到的地方进行数据本文版权归作者所有，未经授权不得转载。著作权归作者所有，禁止商业用途转载。类型判断，在业务代码里面反复的去写，去判【版权所有】唐霜 www.tangshuang.net【版权所有，侵权必究】断数据类型是否符合我的需要，只有在数据类【原创不易，请尊重版权】【作者：唐霜】型满足操作之后，才进行下一步操作。但是，原创内容，盗版必究。著作权归作者所有，禁止商业用途转载。这样反复的在业务代码中写逻辑判断，会让大【版权所有，侵权必究】【原创不易，请尊重版权】部分时间都浪费掉，而且最要命的是，你无法本文版权归作者所有，未经授权不得转载。【原创不易，请尊重版权】完全做到不遗漏的判断，总有时候会疏忽某个【未经授权禁止转载】本文作者：唐霜，转载请注明出处。检查而导致bug。

我实在不能忍受这种情况的继续发生，所以，著作权归作者所有，禁止商业用途转载。【访问 www.tangshuang.net 获取更多精彩内容】我写了HelloType，一方面是解决这【未经授权禁止转载】【转载请注明来源】一现实问题，另一方面也算是自己在js弱数【访问 www.tangshuang.net 获取更多精彩内容】【版权所有】唐霜 www.tangshuang.net据类型下的探索。因此，我希望写一个手册，【本文首发于唐霜的博客】【版权所有】唐霜 www.tangshuang.net不仅把怎么使用HelloType说清楚，原创内容，盗版必究。著作权归作者所有，禁止商业用途转载。也希望能把自己在这个过程中的一些思想讲清未经授权，禁止复制转载。本文版权归作者所有，未经授权不得转载。楚，这也可以为其他开发者提供一些思维上的【本文受版权保护】著作权归作者所有，禁止商业用途转载。借鉴。

基础概念

HelloType中的“类型”和编程语言未经授权，禁止复制转载。【转载请注明来源】里面的“类型”是有区别的，在HelloT【关注微信公众号：wwwtangshuangnet】【作者：唐霜】ype里面的“类型”更多的是指一个容器，本文版权归作者所有，未经授权不得转载。【转载请注明来源】本质也就是一个js对象实例，这个实例拥有【本文首发于唐霜的博客】未经授权，禁止复制转载。一些方法，利用这些方法，就可以判断一个变原创内容，盗版必究。著作权归作者所有，禁止商业用途转载。量所存储的数据是不是符合这个类型的要求。

未经授权，禁止复制转载。【关注微信公众号：wwwtangshua【转载请注明来源】【本文受版权保护】ngnet】本文版权归作者所有，未经授权不得转载。转载请注明出处：www.tangshua【访问 www.tangshuang.net 获取更多精彩内容】本文版权归作者所有，未经授权不得转载。ng.net

在js语言中，基本数据类型只有numbe【原创不易，请尊重版权】著作权归作者所有，禁止商业用途转载。r, boolean, string, 【作者：唐霜】转载请注明出处：www.tangshuang.netnull, undefined, sym未经授权，禁止复制转载。【作者：唐霜】bol这几种，其他所有复杂的数据类型，都未经授权，禁止复制转载。【转载请注明来源】是由object这种类型扩展出来的，因此【未经授权禁止转载】【本文受版权保护】，js里面只有7种数据类型。但是，js里【原创内容，转载请注明出处】【原创不易，请尊重版权】面却没有一种方法可以区分出这7种类型，使【转载请注明来源】未经授权，禁止复制转载。用最多的typeof除了这几种类型外，还本文作者：唐霜，转载请注明出处。【转载请注明来源】会给出function，而null无法得【作者：唐霜】【版权所有，侵权必究】到。还有坑是，NaN的数据类型是numb原创内容，盗版必究。转载请注明出处：www.tangshuang.neter。也就是说，在js里面没有绝对的办法【本文受版权保护】【原创内容，转载请注明出处】确定某个变量的值一定是某个类型。为了解决本文版权归作者所有，未经授权不得转载。本文版权归作者所有，未经授权不得转载。这个问题，在HelloType中我重新对【本文首发于唐霜的博客】未经授权，禁止复制转载。js的数据类型进行规整。

原型 prototype

本文版权归作者所有，未经授权不得转载。【未经授权禁止转载】

Number 数值，不包含NaN和Fin本文作者：唐霜，转载请注明出处。【关注微信公众号：wwwtangshuangnet】ite

【本文受版权保护】

未经授权，禁止复制转载。

String 字符串

著作权归作者所有，禁止商业用途转载。

Boolean 逻辑值，只包含true和本文作者：唐霜，转载请注明出处。转载请注明出处：www.tangshuang.netfalse

本文版权归作者所有，未经授权不得转载。

Array 数组

【原创内容，转载请注明出处】

【原创不易，请尊重版权】

【关注微信公众号：wwwtangshua【关注微信公众号：wwwtangshuangnet】本文作者：唐霜，转载请注明出处。ngnet】

【本文受版权保护】

Object 对象，不包含其他对obje【版权所有，侵权必究】未经授权，禁止复制转载。ct进行扩展后的对象

著作权归作者所有，禁止商业用途转载。

【原创不易，请尊重版权】

Function 函数

【转载请注明来源】

【原创内容，转载请注明出处】

RegExp 正则表达式

本文版权归作者所有，未经授权不得转载。

本文作者：唐霜，转载请注明出处。

【本文受版权保护】

【关注微信公众号：wwwtangshua【未经授权禁止转载】未经授权，禁止复制转载。ngnet】

Symbol 标识符

本文版权归作者所有，未经授权不得转载。

转载请注明出处：www.tangshua原创内容，盗版必究。未经授权，禁止复制转载。ng.net

【原创不易，请尊重版权】

【转载请注明来源】

Null 仅包含null

【转载请注明来源】

Undefined 仅包含undefined

【本文首发于唐霜的博客】

本文作者：唐霜，转载请注明出处。

NaN 仅包含NaN

著作权归作者所有，禁止商业用途转载。

Infinity 仅包含Infinity

【原创内容，转载请注明出处】

未经授权，禁止复制转载。

Date 日期

本文作者：唐霜，转载请注明出处。

【本文受版权保护】

【关注微信公众号：wwwtangshua【未经授权禁止转载】【未经授权禁止转载】ngnet】

【原创内容，转载请注明出处】

Any 可为任意值的原型

未经授权，禁止复制转载。

本文版权归作者所有，未经授权不得转载。

上面红色标记的是我扩展出的原型，需要通过import { Null, Undefined, Any } from 'hello-type'引入。除了上面列出来的一些原生的数据原型【版权所有】唐霜 www.tangshuang.net本文作者：唐霜，转载请注明出处。，js中其他没有列出来的原型也可以在这个【版权所有】唐霜 www.tangshuang.net原创内容，盗版必究。列表中，只不过我这里列出了最常见的，其他本文作者：唐霜，转载请注明出处。著作权归作者所有，禁止商业用途转载。任何原型都是可以用的，甚至包括Error【原创不易，请尊重版权】著作权归作者所有，禁止商业用途转载。，Promise等等。另外，我们还可以自【关注微信公众号：wwwtangshuangnet】原创内容，盗版必究。己创建原型，就跟js里面创建一个带pro【作者：唐霜】【本文受版权保护】totype的function，或者直接【作者：唐霜】【版权所有】唐霜 www.tangshuang.net用class声明一个类一样，自己写一个类转载请注明出处：www.tangshuang.net【关注微信公众号：wwwtangshuangnet】，然后以这个类为原型，那么基于这个原型的【原创不易，请尊重版权】【版权所有，侵权必究】容器，在断言类的实例的时候，是可以通过的原创内容，盗版必究。【访问 www.tangshuang.net 获取更多精彩内容】。

【转载请注明来源】【关注微信公众号：wwwtangshua【原创内容，转载请注明出处】【本文受版权保护】ngnet】【作者：唐霜】

容器 Type

我们有了原型，并不能直接使用原型和具体的【未经授权禁止转载】【版权所有】唐霜 www.tangshuang.net某个值进行对比，然后就得出这个值是不是符【作者：唐霜】原创内容，盗版必究。合这个原型对应的数据类型。我们需要借助一本文版权归作者所有，未经授权不得转载。【原创不易，请尊重版权】个数据类型容器。所谓数据类型容器，其实是著作权归作者所有，禁止商业用途转载。本文版权归作者所有，未经授权不得转载。说将原型本身包裹起来，这样，利用容器的统原创内容，盗版必究。未经授权，禁止复制转载。一方法，就可以进行类型判别（断言）。He【转载请注明来源】【访问 www.tangshuang.net 获取更多精彩内容】lloType是怎么做的呢？就是提供了一著作权归作者所有，禁止商业用途转载。【关注微信公众号：wwwtangshuangnet】个Type构造器，构造一个容器，例如：

著作权归作者所有，禁止商业用途转载。【访问 www.tangshuang.n本文作者：唐霜，转载请注明出处。【转载请注明来源】et 获取更多精彩内容】

const NumberType = new Type(Number)

【本文首发于唐霜的博客】【转载请注明来源】【作者：唐霜】

NumberType.assert(1) // 不会抛出错误
NumberType.assert('1') // 会抛出错误

我这里用了“断言”作为类型校验的动词，主未经授权，禁止复制转载。【原创不易，请尊重版权】要是因为我认为数据类型校验其实是一个非必原创内容，盗版必究。【原创内容，转载请注明出处】须的动作，它不是业务逻辑的必须部分，而是著作权归作者所有，禁止商业用途转载。【转载请注明来源】我们附加的逻辑，但是在写代码时又不得不加【访问 www.tangshuang.net 获取更多精彩内容】【本文受版权保护】入而已。数据类型校验先于所有业务逻辑，期【未经授权禁止转载】【版权所有】唐霜 www.tangshuang.net望被校验的数据符合数据类型，当校验不通过【作者：唐霜】原创内容，盗版必究。时，容器可以发出阻断指令，因此，用“断言【原创内容，转载请注明出处】【原创内容，转载请注明出处】”也比较形象。

【本文受版权保护】【本文受版权保护】

当然，容器还有其他方法，用以满足不同的数【转载请注明来源】未经授权，禁止复制转载。据类型检查需要。下文我会详细介绍容器的各转载请注明出处：www.tangshuang.net转载请注明出处：www.tangshuang.net个方法，这里就暂时做概念的介绍。

著作权归作者所有，禁止商业用途转载。【原创内容，转载请注明出处】

型式 pattern

如果仅仅有原型和容器，还不足以满足我们对著作权归作者所有，禁止商业用途转载。本文作者：唐霜，转载请注明出处。数据类型的检查。因为我们在实际开发中会出【未经授权禁止转载】转载请注明出处：www.tangshuang.net现多种嵌套的数据形式，因此我们要有一种方【关注微信公众号：wwwtangshuangnet】本文作者：唐霜，转载请注明出处。式可以满足这种需要。

const SomeType = new Type({
  name: String,
  books: [Object],
})

上面红色部分不是原型，但为什么可以传给T本文版权归作者所有，未经授权不得转载。原创内容，盗版必究。ype构造器呢？因为它被我称为型式（pa著作权归作者所有，禁止商业用途转载。未经授权，禁止复制转载。ttern），它是形式化的数据结构，这个【未经授权禁止转载】未经授权，禁止复制转载。结构将对数据进行约束。也就是说，如果你用未经授权，禁止复制转载。未经授权，禁止复制转载。SomeType去校验一个对象，那么对象【访问 www.tangshuang.net 获取更多精彩内容】著作权归作者所有，禁止商业用途转载。必须有name、books两个属性，而且转载请注明出处：www.tangshuang.net【本文首发于唐霜的博客】books属性值必须是数组。实际上，任何【版权所有】唐霜 www.tangshuang.net【关注微信公众号：wwwtangshuangnet】被传入Type构造器的都是一个型式，包括【原创不易，请尊重版权】本文版权归作者所有，未经授权不得转载。前面直接传Number，“Number”本文作者：唐霜，转载请注明出处。【本文受版权保护】本身也被认为是一个型式。

规则 Rule

本文版权归作者所有，未经授权不得转载。本文作者：唐霜，转载请注明出处。

const SomeType = new Type({
  name: String,
  age: IfExists(Number),
})
// String和IfExists(Number)就是name和age的规则

HelloType支持如下规则：

本文版权归作者所有，未经授权不得转载。【转载请注明来源】【本文受版权保护】【未经授权禁止转载】

JS原型：Number，String，A【访问 www.tangshuang.net 获取更多精彩内容】【版权所有，侵权必究】rray …

【转载请注明来源】

本文作者：唐霜，转载请注明出处。

【本文受版权保护】

Rule的实例：如new Rule(va【未经授权禁止转载】【原创内容，转载请注明出处】lue => typeof val【作者：唐霜】【关注微信公众号：wwwtangshuangnet】ue ===’object&【原创内容，转载请注明出处】未经授权，禁止复制转载。#8217;),

【原创不易，请尊重版权】

【未经授权禁止转载】

基于Rule的原型：Any，Undefi【作者：唐霜】【访问 www.tangshuang.net 获取更多精彩内容】ned，Null这三个扩展的原型

未经授权，禁止复制转载。

【转载请注明来源】

基于Rule的内置规则：IfExists【关注微信公众号：wwwtangshuangnet】【转载请注明来源】, InstanceOf, Equal等本文版权归作者所有，未经授权不得转载。著作权归作者所有，禁止商业用途转载。（下文介绍）

【作者：唐霜】

转载请注明出处：www.tangshua【原创内容，转载请注明出处】【本文受版权保护】ng.net

本文作者：唐霜，转载请注明出处。

Type的实例：如new Type(Nu转载请注明出处：www.tangshuang.net转载请注明出处：www.tangshuang.netmber)

【未经授权禁止转载】

本文版权归作者所有，未经授权不得转载。

具体的某个值：当规则为具体的值时，表示要本文作者：唐霜，转载请注明出处。未经授权，禁止复制转载。比较的值必须和给定的值相等，如果R著作权归作者所有，禁止商业用途转载。【本文首发于唐霜的博客】17;tomy’, 10, 【版权所有】唐霜 www.tangshuang.net本文作者：唐霜，转载请注明出处。true …

本文版权归作者所有，未经授权不得转载。

HelloType内置了几种基于Rule【本文受版权保护】未经授权，禁止复制转载。的规则：

转载请注明出处：www.tangshua未经授权，禁止复制转载。本文版权归作者所有，未经授权不得转载。ng.net【本文受版权保护】本文作者：唐霜，转载请注明出处。【转载请注明来源】

IfExists(rule) 如果该值存未经授权，禁止复制转载。本文版权归作者所有，未经授权不得转载。在，就进行必须符合传入的规则

本文作者：唐霜，转载请注明出处。

未经授权，禁止复制转载。

【未经授权禁止转载】

InstanceOf(prototype转载请注明出处：www.tangshuang.net【本文首发于唐霜的博客】) 该值是否是某个传入的JS原型的实例

【原创不易，请尊重版权】

Equal(value) 该值必须和传入未经授权，禁止复制转载。本文作者：唐霜，转载请注明出处。的value值相等，value可以为任意【原创不易，请尊重版权】【原创不易，请尊重版权】可用于比较的值（NaN除外）

【原创内容，转载请注明出处】

【未经授权禁止转载】

【本文首发于唐霜的博客】

IfNotMatch(rule, def【版权所有】唐霜 www.tangshuang.net【原创不易，请尊重版权】aultValue) 如果值不符合传入的【作者：唐霜】【本文受版权保护】规则，那么使用defaultValue替【版权所有】唐霜 www.tangshuang.net本文版权归作者所有，未经授权不得转载。换，仅对对象的属性值有效

【关注微信公众号：wwwtangshua【转载请注明来源】【未经授权禁止转载】ngnet】

本文作者：唐霜，转载请注明出处。

本文版权归作者所有，未经授权不得转载。

Lambda(paramsType, r【关注微信公众号：wwwtangshuangnet】未经授权，禁止复制转载。eturnType) 值必须是一个函数，【未经授权禁止转载】【转载请注明来源】而且函数的参数、返回值必须符合要求，仅对本文版权归作者所有，未经授权不得转载。转载请注明出处：www.tangshuang.net对象的属性值有效

【本文首发于唐霜的博客】

【未经授权禁止转载】

比如，我们可以这样使用某个内置规则：

本文版权归作者所有，未经授权不得转载。【未经授权禁止转载】

const SomeType = new Type({
 name: String,
 age: IfExists(Number), // 当obj.age存在时，它的值必须是一个数字，如果obj.age不存在，则忽略这个检查
})

我们可以利用HelloType提供的构造【作者：唐霜】【本文首发于唐霜的博客】器创建自己的规则：

import { Rule } from 'hello-type'

const SomeRule = new Rule(function(value) {
  if (typeof value !== 'object') {
    return new Error('your passed value is not an object')
  }
})

这样你就可以像Number，String【本文受版权保护】【转载请注明来源】这样使用SomeRule了，Null，U【作者：唐霜】【原创不易，请尊重版权】ndefined，Any这三个扩展原型都原创内容，盗版必究。【转载请注明来源】是这样出来的。

未经授权，禁止复制转载。原创内容，盗版必究。

小结

在实际开发中，你根本不需要去思考这些概念原创内容，盗版必究。本文作者：唐霜，转载请注明出处。，所有使用都凭着感觉走，只要记住几个禁忌原创内容，盗版必究。【访问 www.tangshuang.net 获取更多精彩内容】即可，例如记住Lambda仅能用于对象的【版权所有，侵权必究】著作权归作者所有，禁止商业用途转载。属性值，IfExists只能用于对象属性未经授权，禁止复制转载。【本文首发于唐霜的博客】值、数组元素、Tuple的末尾参数。这些未经授权，禁止复制转载。【关注微信公众号：wwwtangshuangnet】禁忌如果可能的话，我会在最后列出来。

本文版权归作者所有，未经授权不得转载。【原创不易，请尊重版权】

快速入门

这一章基于对一个api返回数据的类型检查【未经授权禁止转载】【本文首发于唐霜的博客】的场景，教你快速上手HelloType。

包的安装和使用

本文作者：唐霜，转载请注明出处。【未经授权禁止转载】

npm install --save hello-type

接下来在你的项目中使用这个包，它支持ES本文版权归作者所有，未经授权不得转载。原创内容，盗版必究。6、AMD的模块引入，也支持直接联入到H【关注微信公众号：wwwtangshuangnet】著作权归作者所有，禁止商业用途转载。TML文档中使用。

转载请注明出处：www.tangshua【原创内容，转载请注明出处】本文作者：唐霜，转载请注明出处。ng.net转载请注明出处：www.tangshua未经授权，禁止复制转载。本文作者：唐霜，转载请注明出处。ng.net【访问 www.tangshuang.n【版权所有】唐霜 www.tangshuang.net【访问 www.tangshuang.net 获取更多精彩内容】et 获取更多精彩内容】【版权所有】唐霜 www.tangshu【本文首发于唐霜的博客】【版权所有，侵权必究】ang.net

// ES6
import { Type } from 'hello-type'

// CommonJS
const { Type } = require('hello-type')

// AMD or CMD
define(['hello-type'], function(hello_type) {
  const { Type } = hello_type
})

【作者：唐霜】转载请注明出处：www.tangshua原创内容，盗版必究。【原创内容，转载请注明出处】ng.net转载请注明出处：www.tangshua【原创不易，请尊重版权】本文作者：唐霜，转载请注明出处。ng.net【本文首发于唐霜的博客】

<script src="hello-type/dist/hello-type.js"></script>
<script>
const { Type } = window['hello-type'] // 注意这里的使用方法
</script>

创建类型检查容器

在使用HelloType进行数据校验之前【原创内容，转载请注明出处】【访问 www.tangshuang.net 获取更多精彩内容】，你需要先进行数据类型的规定，通过创建一本文作者：唐霜，转载请注明出处。【作者：唐霜】个容器，把规定固定下来。

【本文首发于唐霜的博客】【未经授权禁止转载】【访问 www.tangshuang.n【本文首发于唐霜的博客】【本文受版权保护】et 获取更多精彩内容】本文作者：唐霜，转载请注明出处。

const BookType = new Type({
  name: String,
  price: Number,
})

一般而言，一个项目里面会有很多这样的初始原创内容，盗版必究。本文作者：唐霜，转载请注明出处。化工作，所以，为了方便项目管理，最好把所未经授权，禁止复制转载。本文作者：唐霜，转载请注明出处。有这种形式的代码集中起来。目录结构如下：

未经授权，禁止复制转载。【原创内容，转载请注明出处】【未经授权禁止转载】【本文受版权保护】

|-types
|  |-person
|  |-book
|  |  |-book.type.js
|  |-benifit
|-controllers
|  |-shop.controller.js

如上，创建了一个types目录，用来保管著作权归作者所有，禁止商业用途转载。原创内容，盗版必究。所有的type相关文件，甚至为了区分，文【未经授权禁止转载】【转载请注明来源】件命名时使用了.type.js后缀。

// book.type.js
import { Type } from 'hello-type'

export const BookType = new Type({
  name: String,
  author: String,
})

// shop.controller.js
import HelloType from 'hello-type'
import { BookType } from '../types/book/book.type.js

export default class ShopController {
  sell(book) {
    // 在所有业务代码运行之前，用HelloType对方法函数的参数类型进行检查
    // 如果别的地方调用sell方法时，传入的book不符合BookType的规定，那么这里会直接抛出错误，方法无法继续执行
    HelloType.expect(book).to.match(BookType)

    // 具体的业务逻辑代码
  }
}

对API数据进行检查

import { Dict, List, IfExists, Type, HelloType } from 'hello-type'

export const NumberType = new Type(Number)
export const BooksType = List([
  IfExists({
    name: String,
    age: Number,
  })
])
export const BooksResType = Dict({
  code: Number,
  data: BooksType,
})

async function getBookDetail(id) {
  HelloType.expect(id).to.match(NumberType) // 对函数的输入进行类型断言
  
  let res = await fetch(apiUrlBase + '/books/' + id)
  let data = await res.json()
  HelloType.expect(data).to.match(BooksResType)
  
  // 由于对api接口返回的数据进行了断言，如果程序能够执行到这里，那么说明api返回的数据符合要求，下面的操作不必有任何担心

  let books = data.data
  books.forEach((book) => {
    // ...
  })

  HelloType.expect(books).to.match(BooksType) // 对函数的返回值进行类型断言
  return books
}

这样就完成了对API返回数据的类型断言，【作者：唐霜】【作者：唐霜】由于这是一个async函数，因此，当断言未经授权，禁止复制转载。【转载请注明来源】中报错时，会阻止程序继续往下执行，并抛出【转载请注明来源】本文版权归作者所有，未经授权不得转载。错误，在使用函数时，可以通过catch获【未经授权禁止转载】【版权所有，侵权必究】取到抛出的错误内容，并对错误内容进行解读【版权所有】唐霜 www.tangshuang.net【原创不易，请尊重版权】（例如上传到监控系统）。

转载请注明出处：www.tangshua【本文受版权保护】【原创不易，请尊重版权】ng.net未经授权，禁止复制转载。

Type

利用Type可以创建一个容器，它是一个构著作权归作者所有，禁止商业用途转载。著作权归作者所有，禁止商业用途转载。造器，也是一个ES6的class，因此在转载请注明出处：www.tangshuang.net【转载请注明来源】使用时要用new去实例化。它没有任何配置【本文受版权保护】【转载请注明来源】项，每一个传入的值，都是一个型式，型式可著作权归作者所有，禁止商业用途转载。【作者：唐霜】以是任意内容，它会按照一定的规则进行型式【版权所有】唐霜 www.tangshuang.net【版权所有】唐霜 www.tangshuang.net的格式化，形成规则体现。

constructor

const NumberType = new Type(Number)

上面这段代码就创建了一个基于Number著作权归作者所有，禁止商业用途转载。本文版权归作者所有，未经授权不得转载。的类型容器，它用来检查一个值是不是一个数原创内容，盗版必究。【原创不易，请尊重版权】字。由于js的一些坑，例如NaN的typ【原创内容，转载请注明出处】【本文受版权保护】eof也是number，所以我对这些情况【访问 www.tangshuang.net 获取更多精彩内容】【原创不易，请尊重版权】都进行统一：

未经授权，禁止复制转载。【关注微信公众号：wwwtangshua原创内容，盗版必究。【原创内容，转载请注明出处】ngnet】

Number 仅仅匹配真实的数据，如果是【本文受版权保护】【访问 www.tangshuang.net 获取更多精彩内容】NaN或Infinite，都不能通过

著作权归作者所有，禁止商业用途转载。

本文版权归作者所有，未经授权不得转载。

原创内容，盗版必究。

String 仅仅匹配字符串，str =著作权归作者所有，禁止商业用途转载。【转载请注明来源】 new String中的str是一个对本文作者：唐霜，转载请注明出处。著作权归作者所有，禁止商业用途转载。象，不能通过

原创内容，盗版必究。

【原创内容，转载请注明出处】

【关注微信公众号：wwwtangshua【作者：唐霜】本文版权归作者所有，未经授权不得转载。ngnet】

Boolean 仅仅匹配true和fal【版权所有】唐霜 www.tangshuang.net本文作者：唐霜，转载请注明出处。se这两个值，其他任何值都不通过

【未经授权禁止转载】

转载请注明出处：www.tangshua本文作者：唐霜，转载请注明出处。未经授权，禁止复制转载。ng.net

【作者：唐霜】

Object 仅仅匹配对象的字面量形式和本文版权归作者所有，未经授权不得转载。本文作者：唐霜，转载请注明出处。new Object出来的结果，其他任何本文版权归作者所有，未经授权不得转载。【版权所有，侵权必究】形式的object都不能通过

著作权归作者所有，禁止商业用途转载。

上面这四种类型都做了强制规定，因此，你在【版权所有，侵权必究】【原创内容，转载请注明出处】用它们的时候，真的就跟它们的字面意思一样【访问 www.tangshuang.net 获取更多精彩内容】转载请注明出处：www.tangshuang.net，不会产生副作用。在HelloType的未经授权，禁止复制转载。【本文受版权保护】体系里，所有的原型在上一章已经说过了，这原创内容，盗版必究。【版权所有】唐霜 www.tangshuang.net里就不再赘述。

HelloType希望用js里面最简单直【未经授权禁止转载】未经授权，禁止复制转载。接的思维解决数据类型问题，对一个数据进行【转载请注明来源】【作者：唐霜】类型断言时，我没有发明一种新形式来表示类【转载请注明来源】著作权归作者所有，禁止商业用途转载。型，因为类型是枚举不完的，我看到有一个和转载请注明出处：www.tangshuang.net著作权归作者所有，禁止商业用途转载。hello-type目的相同的库，它通过著作权归作者所有，禁止商业用途转载。本文版权归作者所有，未经授权不得转载。字符串来表达类型，然而，在它的issue原创内容，盗版必究。未经授权，禁止复制转载。列表里，很多都是对这种字符串来表示类型的未经授权，禁止复制转载。【本文受版权保护】一些疑问或希望修改类型名等。而Hello本文版权归作者所有，未经授权不得转载。【访问 www.tangshuang.net 获取更多精彩内容】Type用原生的类型原型作为类型的基础，【本文受版权保护】【本文首发于唐霜的博客】几乎不需要做任何扩展，就可以把js里面所【访问 www.tangshuang.net 获取更多精彩内容】【关注微信公众号：wwwtangshuangnet】有类型囊括进来，这就是所谓以不变应万变吧【未经授权禁止转载】【作者：唐霜】。
著作权归作者所有，禁止商业用途转载。【关注微信公众号：wwwtangshua【本文受版权保护】【本文首发于唐霜的博客】ngnet】【版权所有，侵权必究】【本文受版权保护】

【本文首发于唐霜的博客】转载请注明出处：www.tangshua【访问 www.tangshuang.net 获取更多精彩内容】未经授权，禁止复制转载。ng.net

const ParamsType = new Type(String, Number, Boolean)
ParamsType.assert('tomy', 10, true)

这种一次打包一组数据，但又不是数组的数据【转载请注明来源】【转载请注明来源】形式，我把它扩展为了Tuple（元组），【本文首发于唐霜的博客】未经授权，禁止复制转载。下文会详细介绍。

const SomeType = new Type({
  name: String,
  detail: {
    title: String,
    content: String,
  },
})

虽然内部而言，它其实是一个Dict嵌套的【转载请注明来源】【未经授权禁止转载】结构，但是实际上，在外表上看，它就像一个【本文首发于唐霜的博客】转载请注明出处：www.tangshuang.net普通的对象一样。Dict是字典结构，下文【转载请注明来源】未经授权，禁止复制转载。会详细解释。在构建容器的时候，容器本身，【版权所有】唐霜 www.tangshuang.net【转载请注明来源】只能对object的第一层数据进行校验，【未经授权禁止转载】【转载请注明来源】当有嵌套数据的时候怎么办呢？把被嵌套的型【版权所有】唐霜 www.tangshuang.net【作者：唐霜】式转化为一个Dict容器，这样，虽然容器未经授权，禁止复制转载。原创内容，盗版必究。本身只校验第一层，但是当校验到规则为一个【关注微信公众号：wwwtangshuangnet】【作者：唐霜】容器的时候，它会利用容器，对该属性的值再【关注微信公众号：wwwtangshuangnet】转载请注明出处：www.tangshuang.net次进行校验，而这个时候，这个二级容器，又本文版权归作者所有，未经授权不得转载。【原创不易，请尊重版权】可以去校验下一级的对象。正是因为实现了这【本文受版权保护】著作权归作者所有，禁止商业用途转载。个机制，所以HelloType几乎可以实著作权归作者所有，禁止商业用途转载。【本文受版权保护】现无限层的校验，虽然这是不允许的。虽然我【访问 www.tangshuang.net 获取更多精彩内容】原创内容，盗版必究。这里不能把原理讲明白，但是你只要按照你以【转载请注明来源】转载请注明出处：www.tangshuang.net为的方式去用就好了，并不会有问题。

assert

assert方法是Type容器的最重要方【本文受版权保护】【原创不易，请尊重版权】法，也是所有HelloType方法的基础转载请注明出处：www.tangshuang.net【版权所有，侵权必究】。当你完成Type实例化，创建了一个容器【转载请注明来源】本文版权归作者所有，未经授权不得转载。之后，这个容器实例就自动拥有了一些方法，【关注微信公众号：wwwtangshuangnet】原创内容，盗版必究。assert方法就是需要介绍的第一个方法【本文首发于唐霜的博客】【关注微信公众号：wwwtangshuangnet】。

著作权归作者所有，禁止商业用途转载。【本文受版权保护】【未经授权禁止转载】

const person = {
  name: 'tomy',
  age: 10,
}

PersonType.assert(person) // 断言person符合PersonType的定义

如果person不符合PersonTyp未经授权，禁止复制转载。【版权所有，侵权必究】e的定义，assert会throw Ty转载请注明出处：www.tangshuang.net原创内容，盗版必究。peError，而在js里面，被抛出的错转载请注明出处：www.tangshuang.net转载请注明出处：www.tangshuang.net误，可以被window.onerror监著作权归作者所有，禁止商业用途转载。本文作者：唐霜，转载请注明出处。听到，这非常有用，对于前端异常的监控，或【转载请注明来源】【版权所有】唐霜 www.tangshuang.net者一些特别的逻辑非常有帮助，因此，我才选本文版权归作者所有，未经授权不得转载。著作权归作者所有，禁止商业用途转载。择throw error的形式抛出错误。本文作者：唐霜，转载请注明出处。【关注微信公众号：wwwtangshuangnet】Error还能记录代码的stack信息，【访问 www.tangshuang.net 获取更多精彩内容】【原创内容，转载请注明出处】可以帮助我们快速定位错误位置。

【本文受版权保护】未经授权，禁止复制转载。

assert接收的参数个数，和new T著作权归作者所有，禁止商业用途转载。【本文首发于唐霜的博客】ype时接收的参数个数必须相同，如果不同【本文受版权保护】未经授权，禁止复制转载。，也会抛出错误。因此，对参数个数具有严格【关注微信公众号：wwwtangshuangnet】【本文受版权保护】的要求，你不能用assert一次性校验多未经授权，禁止复制转载。转载请注明出处：www.tangshuang.net个数据，只能反复调用assert来校验。

【未经授权禁止转载】【本文受版权保护】【访问 www.tangshuang.n【本文受版权保护】【原创内容，转载请注明出处】et 获取更多精彩内容】本文作者：唐霜，转载请注明出处。

另外有一点需要注意，HelloType只会在遇到第一个断言失【作者：唐霜】【未经授权禁止转载】败时跳出断言，而不会遍历所有断言。这也就是说，当你assert抛出错误时本文作者：唐霜，转载请注明出处。本文作者：唐霜，转载请注明出处。，并不代表该数据只有一个地方不符合类型，本文作者：唐霜，转载请注明出处。著作权归作者所有，禁止商业用途转载。在你修复了bug之后，需要继续关注，在后未经授权，禁止复制转载。【版权所有】唐霜 www.tangshuang.net面的断言里，还可能出现不符合类型。例如：

【访问 www.tangshuang.n【作者：唐霜】本文作者：唐霜，转载请注明出处。et 获取更多精彩内容】本文作者：唐霜，转载请注明出处。【作者：唐霜】

const SomeType = new Type({
  name: String,
  age: Number,
})
const some = {}
SomeType.assert(some) // 在对name属性值进行断言的时候抛出错误，并终止断言。但是你会发现，其实age属性也不符合要求。

test

assert方法会通过throw Typ【访问 www.tangshuang.net 获取更多精彩内容】【本文受版权保护】eError抛出错误，这可能不是你想要的【版权所有】唐霜 www.tangshuang.net【转载请注明来源】，你可能只想看看这个数据是否符合规定，如【本文受版权保护】【本文首发于唐霜的博客】果符合返回一个true，不符合返回一个f本文版权归作者所有，未经授权不得转载。本文作者：唐霜，转载请注明出处。alse。test方法就是做这件事的。

let bool = PersonType.test(person) // true
if (!bool) {
  alert('person does not match PersonType')
}

catch

test方法虽然可以让你判断，但是你希望本文版权归作者所有，未经授权不得转载。未经授权，禁止复制转载。还能获取到具体的错误信息，catch方法本文作者：唐霜，转载请注明出处。转载请注明出处：www.tangshuang.net就可以帮助你捕获错误而不抛出任何错误。

let error = PersonType.catch(person)
if (error) {
  console.log(error.stack)
}

catch方法会把捕获到的错误返回，如果【本文受版权保护】原创内容，盗版必究。没有错误发生，就返回null。

track.with

不过有的时候，你并不希望HelloTyp【转载请注明来源】【原创内容，转载请注明出处】e终止你的程序，但你又不想用catch，【本文受版权保护】未经授权，禁止复制转载。多加一层判断，这个时候，你可以使用tra著作权归作者所有，禁止商业用途转载。【本文首发于唐霜的博客】ck.with，异步处理错误。

【作者：唐霜】未经授权，禁止复制转载。未经授权，禁止复制转载。【本文受版权保护】

PersonType.track(person).with((error) => {
  // ...
})

使用这个语句，本身不会让程序终止，它在断【版权所有】唐霜 www.tangshuang.net未经授权，禁止复制转载。言之后，如果发现不符合类型，就会执行fn【未经授权禁止转载】【访问 www.tangshuang.net 获取更多精彩内容】，并把error传给fn。不过，如果在f【版权所有】唐霜 www.tangshuang.net【本文受版权保护】n中抛出错误就看你自己了。利用track【未经授权禁止转载】【原创不易，请尊重版权】.with，你就可以在不影响函数的正常执【关注微信公众号：wwwtangshuangnet】本文作者：唐霜，转载请注明出处。行的情况下，还可以抓取到数据类型错误信息未经授权，禁止复制转载。【作者：唐霜】。

【原创内容，转载请注明出处】【原创内容，转载请注明出处】【原创内容，转载请注明出处】本文版权归作者所有，未经授权不得转载。

trace.with

track和trace的区别，在英文里面本文版权归作者所有，未经授权不得转载。本文版权归作者所有，未经授权不得转载。是这样的，track追踪的是从起点到当前【版权所有，侵权必究】【转载请注明来源】点的线索，而trace是从当前点开始往后【本文受版权保护】【本文受版权保护】跟踪。假如你是一个侦探，正在怀疑一个人是【转载请注明来源】未经授权，禁止复制转载。凶手，你在不停的找他的犯罪证据或者线索就【关注微信公众号：wwwtangshuangnet】转载请注明出处：www.tangshuang.net是track，而你在他身上偷偷安装跟踪器本文作者：唐霜，转载请注明出处。【原创不易，请尊重版权】进行跟踪就是trace。在HelloTy本文版权归作者所有，未经授权不得转载。【原创内容，转载请注明出处】pe体系里，trace.with和tra【版权所有，侵权必究】【作者：唐霜】ck.with的用法是一模一样的，只不过著作权归作者所有，禁止商业用途转载。【版权所有】唐霜 www.tangshuang.net执行的进程不同。track的前半部分是同【本文受版权保护】本文作者：唐霜，转载请注明出处。步的，会阻塞进程。而trace会完全异步【版权所有，侵权必究】【版权所有，侵权必究】执行的，也就是说它会在异步执行时才会去检转载请注明出处：www.tangshuang.net【未经授权禁止转载】查数据的类型错误。这也就是说，如果你在函【转载请注明来源】本文版权归作者所有，未经授权不得转载。数的执行过程中如果改动了数据，trace本文作者：唐霜，转载请注明出处。本文版权归作者所有，未经授权不得转载。是先不管的，只有当函数中的同步进程执行完转载请注明出处：www.tangshuang.net未经授权，禁止复制转载。了，trace才会对数据进行检查，而这个【版权所有，侵权必究】【版权所有】唐霜 www.tangshuang.net时候，trace检查的是修改过的数据，因【关注微信公众号：wwwtangshuangnet】【关注微信公众号：wwwtangshuangnet】此，在使用trace.with的时候一定未经授权，禁止复制转载。【版权所有】唐霜 www.tangshuang.net要注意这点。

之所以提供trace和track，主要是【未经授权禁止转载】【版权所有】唐霜 www.tangshuang.net从性能上考虑，track是同步执行的，对【版权所有，侵权必究】【关注微信公众号：wwwtangshuangnet】性能有所影响，而trace是完全异步执行【关注微信公众号：wwwtangshuangnet】本文作者：唐霜，转载请注明出处。的，因此不仅不会由于抛出错误而终止进程，【本文受版权保护】【本文受版权保护】而且还把对数据对判断放到末尾去做，因此对【转载请注明来源】未经授权，禁止复制转载。界面的渲染一点影响都没有。不过最惨的地方未经授权，禁止复制转载。未经授权，禁止复制转载。在于，如果你在代码中修改了数据，那tra【转载请注明来源】【未经授权禁止转载】ce得到的结果可能就跟你预期的不同了。因著作权归作者所有，禁止商业用途转载。【未经授权禁止转载】此使用的时候一定要注意。

本文版权归作者所有，未经授权不得转载。著作权归作者所有，禁止商业用途转载。【未经授权禁止转载】本文作者：唐霜，转载请注明出处。

严格模式

在进行断言的时候，默认情况下，Hello【本文受版权保护】【原创不易，请尊重版权】Type会使用兼容模式。当断言一个对象的【作者：唐霜】【版权所有，侵权必究】时候，当一个对象里面有一个属性是type【版权所有，侵权必究】【版权所有，侵权必究】规定的对象里没有规定的时候，不会产生任何转载请注明出处：www.tangshuang.net本文作者：唐霜，转载请注明出处。问题，（type里有的一定会校验，）也就本文作者：唐霜，转载请注明出处。【转载请注明来源】是忽略不校验。而如果是严格模式，则要求对【原创不易，请尊重版权】本文版权归作者所有，未经授权不得转载。象的属性和type规定的一模一样，如果被【原创内容，转载请注明出处】未经授权，禁止复制转载。检查的对象多了一些属性是type里面没有【关注微信公众号：wwwtangshuangnet】【访问 www.tangshuang.net 获取更多精彩内容】规定的，那么也会报错。

转载请注明出处：www.tangshua【转载请注明来源】【本文受版权保护】ng.net【作者：唐霜】【作者：唐霜】【作者：唐霜】

那么怎么开启严格模式呢？有两种方式：

PersonType.toBeStrict()

将PersonType切换为严格模式。

let StrictPersonType = PersonType.Strict

返回一个拷贝，而这个拷贝是严格模式的。s【转载请注明来源】【未经授权禁止转载】trct和Strict是一模一样的，你也【关注微信公众号：wwwtangshuangnet】著作权归作者所有，禁止商业用途转载。可以用someType.strict，只【版权所有，侵权必究】【原创不易，请尊重版权】是为了让使用的时候，根据不同开发者的习惯著作权归作者所有，禁止商业用途转载。【访问 www.tangshuang.net 获取更多精彩内容】，提供大小写区别的方式。

著作权归作者所有，禁止商业用途转载。原创内容，盗版必究。原创内容，盗版必究。

为什么要提供两种方式呢？因为切换模式是直本文作者：唐霜，转载请注明出处。【作者：唐霜】接让当前容器进行改变，也就是说，如果你在【访问 www.tangshuang.net 获取更多精彩内容】转载请注明出处：www.tangshuang.net其他地方也使用到了该容器，那就会有影响，原创内容，盗版必究。【版权所有】唐霜 www.tangshuang.net而strict则不会改变当前容器，而是返本文作者：唐霜，转载请注明出处。【作者：唐霜】回一个新容器，只不过这个容器是严格模式的【本文受版权保护】【关注微信公众号：wwwtangshuangnet】。大部分情况下，推荐使用strict来获未经授权，禁止复制转载。【原创内容，转载请注明出处】取一个新容器，防止对其他实例造成影响。

【本文受版权保护】未经授权，禁止复制转载。【本文首发于唐霜的博客】

严格模式会自动继承给被嵌套的容器，例如：

【转载请注明来源】【关注微信公众号：wwwtangshua【关注微信公众号：wwwtangshuangnet】未经授权，禁止复制转载。ngnet】【关注微信公众号：wwwtangshua【原创内容，转载请注明出处】【本文首发于唐霜的博客】ngnet】【转载请注明来源】

const SubType = new Type({
  name: String,
})
const ParentType = new Type({
  name: String,
  child: SubType,
})

ParentType.toBeStrict()
PerentType.assert({
  name: 'jhon',
  child: {
    name: 'tomy',
    age: 10,
  },
})

上面的校验会抛出错误，因为child.a原创内容，盗版必究。【作者：唐霜】ge设置了值，而严格模式下，被嵌套的容器【转载请注明来源】本文作者：唐霜，转载请注明出处。也会转化为严格模式后再使用，因此，你不用本文作者：唐霜，转载请注明出处。转载请注明出处：www.tangshuang.net自己手动嵌套一个严格模式的容器。而且，这【原创内容，转载请注明出处】【版权所有，侵权必究】种情况，SubType自身不会被切换为严【本文首发于唐霜的博客】著作权归作者所有，禁止商业用途转载。格模式，内部使用的是SubType.St本文作者：唐霜，转载请注明出处。【转载请注明来源】rict，因此你可以放心使用。

未经授权，禁止复制转载。【未经授权禁止转载】著作权归作者所有，禁止商业用途转载。

扩展数据类型

js的基础数据类型显然不够用，所有的复杂【本文受版权保护】【关注微信公众号：wwwtangshuangnet】数据都基于object进行扩展，所以到最未经授权，禁止复制转载。【原创内容，转载请注明出处】后instanceof Object都是【本文首发于唐霜的博客】【版权所有，侵权必究】true。我希望通过HelloType，【原创内容，转载请注明出处】原创内容，盗版必究。对js的数据类型扩展，在进行数据类型检查【版权所有】唐霜 www.tangshuang.net本文作者：唐霜，转载请注明出处。的时候，让数据类型有所归属。基于这种想法转载请注明出处：www.tangshuang.net著作权归作者所有，禁止商业用途转载。，我扩展出了5种，但实际上，基于已有的原【原创内容，转载请注明出处】【访问 www.tangshuang.net 获取更多精彩内容】材料，你可以扩展出自己的数据类型（容器）【关注微信公众号：wwwtangshuangnet】【关注微信公众号：wwwtangshuangnet】。

转载请注明出处：www.tangshua未经授权，禁止复制转载。原创内容，盗版必究。ng.net【原创不易，请尊重版权】【本文首发于唐霜的博客】

【未经授权禁止转载】著作权归作者所有，禁止商业用途转载。

Dict 字典

实际上，我在HelloType里面对一个【未经授权禁止转载】【版权所有，侵权必究】对象进行检查时，只会对真正的对象进行检查本文作者：唐霜，转载请注明出处。本文作者：唐霜，转载请注明出处。，也就是说，一个function、一个类【版权所有】唐霜 www.tangshuang.net原创内容，盗版必究。的实例，虽然它们在js里面都是对象，但是著作权归作者所有，禁止商业用途转载。未经授权，禁止复制转载。实际上，在HelloType里面它们会被著作权归作者所有，禁止商业用途转载。【本文首发于唐霜的博客】认为是自己真实的本质，而不是一个对象。而【版权所有，侵权必究】【访问 www.tangshuang.net 获取更多精彩内容】Dict就代表对象本身。

转载请注明出处：www.tangshua转载请注明出处：www.tangshuang.net本文作者：唐霜，转载请注明出处。ng.net本文作者：唐霜，转载请注明出处。原创内容，盗版必究。

Dict是一个函数，接收一个对象型式，返【作者：唐霜】【版权所有，侵权必究】回一个容器

本文作者：唐霜，转载请注明出处。

本文版权归作者所有，未经授权不得转载。

不传参数时，默认表示要断言的值必须是一个【版权所有】唐霜 www.tangshuang.net【作者：唐霜】对象，内部结构不校验

【原创内容，转载请注明出处】

【转载请注明来源】

【访问 www.tangshuang.n本文版权归作者所有，未经授权不得转载。未经授权，禁止复制转载。et 获取更多精彩内容】

传入的型式不是一个对象的时候，相当于没有【原创不易，请尊重版权】【本文首发于唐霜的博客】传参数

著作权归作者所有，禁止商业用途转载。

支持嵌套

【转载请注明来源】

在Type的基础上，所有扩展类型都做了强【转载请注明来源】著作权归作者所有，禁止商业用途转载。规定，这样保证这些类型的特殊性。

const DictType = Dict({
  nage: String,
  age: Number,
  children: [IfExists(Object)], // IfExists是一个内置规则，下文会更详细的讲
})

著作权归作者所有，禁止商业用途转载。【原创内容，转载请注明出处】【未经授权禁止转载】【转载请注明来源】

extends

Dict除了通用的判断方法外，还另外有两著作权归作者所有，禁止商业用途转载。【版权所有】唐霜 www.tangshuang.net个特别的方法。extends方法用于对原【版权所有，侵权必究】转载请注明出处：www.tangshuang.net有的规则结构进行扩展，例如，你定义了一个未经授权，禁止复制转载。【版权所有】唐霜 www.tangshuang.netPersonType，但是你现在需要一个【关注微信公众号：wwwtangshuangnet】本文作者：唐霜，转载请注明出处。BoyType，而BoyType实际上拥【未经授权禁止转载】【作者：唐霜】有了PersonType的全部属性，你可【本文首发于唐霜的博客】【关注微信公众号：wwwtangshuangnet】以这样做：

【转载请注明来源】著作权归作者所有，禁止商业用途转载。

const BoyType = PersonType.extends({
  sex: Enum('F', 'M'),
  age: ShouldMatch(Number, Validate(value => value <= 14, `Boy's age should not bigger than 14.`)),
})

extends的参数是新增的属性及其规则【版权所有】唐霜 www.tangshuang.net【访问 www.tangshuang.net 获取更多精彩内容】。也可以通过extends对原有的规则进【未经授权禁止转载】转载请注明出处：www.tangshuang.net行覆盖，当原有类型中存在某个属性时，新给本文作者：唐霜，转载请注明出处。【关注微信公众号：wwwtangshuangnet】定当属性规则会覆盖原有的规则。它返回一个【未经授权禁止转载】【未经授权禁止转载】新的Dict。

extract

和extends相反，extract则是著作权归作者所有，禁止商业用途转载。原创内容，盗版必究。从原有的某些属性中抽取部分作为新的规则集本文版权归作者所有，未经授权不得转载。【原创内容，转载请注明出处】合。它的使用方法如下：

const ChildType = ParentType.extract({
  name: true,
  age: true,
  height: false,
  weight: false,
})

其中，值为true表示在新的ChildT原创内容，盗版必究。【关注微信公众号：wwwtangshuangnet】ype中，这个属性的规则将会被使用，为f【版权所有】唐霜 www.tangshuang.net未经授权，禁止复制转载。alse将会被舍弃。但是，你可能会问，假转载请注明出处：www.tangshuang.net【原创内容，转载请注明出处】如在ParentType中的属性，在使用原创内容，盗版必究。原创内容，盗版必究。extract的时候没有传入怎么办？这种未经授权，禁止复制转载。【原创内容，转载请注明出处】情况会有一个规则去自适配：

原创内容，盗版必究。【关注微信公众号：wwwtangshua本文版权归作者所有，未经授权不得转载。转载请注明出处：www.tangshuang.netngnet】【版权所有】唐霜 www.tangshu未经授权，禁止复制转载。转载请注明出处：www.tangshuang.netang.net【访问 www.tangshuang.n本文版权归作者所有，未经授权不得转载。【原创不易，请尊重版权】et 获取更多精彩内容】

当extract的参数中全部都为fals【原创内容，转载请注明出处】【关注微信公众号：wwwtangshuangnet】e时，表示这些属性会在新容器中全部被舍弃未经授权，禁止复制转载。【原创不易，请尊重版权】，而那些没有被提及的属性会全部被保留下来

本文作者：唐霜，转载请注明出处。

著作权归作者所有，禁止商业用途转载。

当extract的参数中全部都为true本文版权归作者所有，未经授权不得转载。【版权所有，侵权必究】时，表示这些属性会被保留下来，所有没有被未经授权，禁止复制转载。著作权归作者所有，禁止商业用途转载。提及的属性都会被舍弃

本文作者：唐霜，转载请注明出处。

【作者：唐霜】

当参数中部分为true部分为false时转载请注明出处：www.tangshuang.net原创内容，盗版必究。，没有提及的属性会被舍弃（相当于只会保留著作权归作者所有，禁止商业用途转载。【作者：唐霜】被设置了true的那些属性，因此，这种写【本文受版权保护】【未经授权禁止转载】法没有什么意义，一般而言，只需要全部为t【本文首发于唐霜的博客】【版权所有】唐霜 www.tangshuang.netrue或者全部为false）

【原创内容，转载请注明出处】

List 列表

List对应数组，它规定一个数组的每个位转载请注明出处：www.tangshuang.net【原创内容，转载请注明出处】置上元素的类型。

【本文首发于唐霜的博客】【作者：唐霜】

List是一个函数，接收一个数组型式，返原创内容，盗版必究。【转载请注明来源】回一个容器

【作者：唐霜】

未经授权，禁止复制转载。

本文版权归作者所有，未经授权不得转载。

不传参数时，表示要校验的值必须是一个数组转载请注明出处：www.tangshuang.net【原创不易，请尊重版权】，不对内部元素进行校验

原创内容，盗版必究。

本文作者：唐霜，转载请注明出处。

传的不是数组时，相当于没传

著作权归作者所有，禁止商业用途转载。

【作者：唐霜】

支持嵌套

【访问 www.tangshuang.n著作权归作者所有，禁止商业用途转载。转载请注明出处：www.tangshuang.netet 获取更多精彩内容】

【作者：唐霜】

【关注微信公众号：wwwtangshua【未经授权禁止转载】原创内容，盗版必究。ngnet】

const ListType = List([String, Number])

List的校验规则如下：

原创内容，盗版必究。本文版权归作者所有，未经授权不得转载。【本文首发于唐霜的博客】本文作者：唐霜，转载请注明出处。

检查是否是数组

【本文受版权保护】

检查数组元素的个数，被校验的数组长度不能【关注微信公众号：wwwtangshuangnet】【访问 www.tangshuang.net 获取更多精彩内容】少于规定的长度，例如校验[‘转载请注明出处：www.tangshuang.net本文版权归作者所有，未经授权不得转载。sony’]就会失败（通过I【访问 www.tangshuang.net 获取更多精彩内容】【原创不易，请尊重版权】fExists可以对此进行扩展，具体了解著作权归作者所有，禁止商业用途转载。【本文受版权保护】下面对IfExists）

【本文首发于唐霜的博客】

【未经授权禁止转载】

检查数组元素的内部结构（元素类型检查）

【原创不易，请尊重版权】

当被校验数组的长度超出规定长度时，严格模【转载请注明来源】【关注微信公众号：wwwtangshuangnet】式会不通过

【原创内容，转载请注明出处】

原创内容，盗版必究。

转载请注明出处：www.tangshua【原创不易，请尊重版权】【未经授权禁止转载】ng.net

兼容模式下，要求超出部分的元素必须是前面【本文首发于唐霜的博客】【关注微信公众号：wwwtangshuangnet】所规定的类型中的一个，也就是Enum(S【本文受版权保护】【转载请注明来源】tring, Number)

【转载请注明来源】

原创内容，盗版必究。

上述最后一点，当超出长度时，比如用上面的【未经授权禁止转载】【版权所有，侵权必究】ListType去校验[‘t转载请注明出处：www.tangshuang.net【本文首发于唐霜的博客】omy’, 10, true本文作者：唐霜，转载请注明出处。【访问 www.tangshuang.net 获取更多精彩内容】]就会不通过，第二个元素后面的元素必须是本文版权归作者所有，未经授权不得转载。【访问 www.tangshuang.net 获取更多精彩内容】String或Number。

Enum 枚举

枚举在js里面本身是没有的，我扩展出来，未经授权，禁止复制转载。【原创不易，请尊重版权】在HelloType体系里非常有用。它很本文版权归作者所有，未经授权不得转载。【访问 www.tangshuang.net 获取更多精彩内容】简单，要求要校验的值，会用规定的几个规则【本文首发于唐霜的博客】本文版权归作者所有，未经授权不得转载。中的一个去校验：

const EnumType = Enum(String, Number, Boolean)

不过一般而言，很少会这样用，因为我们并不【作者：唐霜】转载请注明出处：www.tangshuang.net希望一个值是多类型的，我们更多的用法是：

const ColorType = Enum('blue', 'red', 'yellow')

前面讲过，具体的某个值也是一种规则，要求【版权所有】唐霜 www.tangshuang.net本文作者：唐霜，转载请注明出处。被校验值必须与该值相等。在Enum中就非未经授权，禁止复制转载。转载请注明出处：www.tangshuang.net常明显，ColorType去校验的时候，本文版权归作者所有，未经授权不得转载。【访问 www.tangshuang.net 获取更多精彩内容】值必须是这三个值中的一个，否则就会不通过本文版权归作者所有，未经授权不得转载。本文作者：唐霜，转载请注明出处。。

本文作者：唐霜，转载请注明出处。本文版权归作者所有，未经授权不得转载。

枚举是一个超级好用的类型，它可以帮助你实【关注微信公众号：wwwtangshuangnet】【作者：唐霜】现各种花式操作，例如：

【原创不易，请尊重版权】【本文首发于唐霜的博客】【原创不易，请尊重版权】

function link(a, b) {
  return a + b
}

原创内容，盗版必究。本文作者：唐霜，转载请注明出处。原创内容，盗版必究。【访问 www.tangshuang.n著作权归作者所有，禁止商业用途转载。【未经授权禁止转载】et 获取更多精彩内容】

const ParamsType = Enum(Tuple(Number, Number), Tuple(String, String))

Tuple 元组

元组是指一组散列的数据，按照一定的顺序组【访问 www.tangshuang.net 获取更多精彩内容】著作权归作者所有，禁止商业用途转载。成一组。它非常适合用来校验函数的参数。

Tuple是一个函数，接收任意数量的任意【访问 www.tangshuang.net 获取更多精彩内容】【原创内容，转载请注明出处】类型的型式，返回一个容器

【关注微信公众号：wwwtangshua原创内容，盗版必究。本文版权归作者所有，未经授权不得转载。ngnet】

【关注微信公众号：wwwtangshua【原创不易，请尊重版权】本文作者：唐霜，转载请注明出处。ngnet】

【访问 www.tangshuang.n【原创不易，请尊重版权】【原创不易，请尊重版权】et 获取更多精彩内容】

不支持嵌套

【本文受版权保护】

未经授权，禁止复制转载。

const TupleType = Tuple(String, Number)

function fun(...args) {
  TupleType.assert(...args)
}

本文作者：唐霜，转载请注明出处。未经授权，禁止复制转载。

校验传入的参数的个数，如果传入参数个数不本文版权归作者所有，未经授权不得转载。【访问 www.tangshuang.net 获取更多精彩内容】一样，不通过

【关注微信公众号：wwwtangshua【作者：唐霜】【转载请注明来源】ngnet】

转载请注明出处：www.tangshua【原创不易，请尊重版权】【原创不易，请尊重版权】ng.net

【未经授权禁止转载】

【本文受版权保护】

校验每个位置上的数据类型

原创内容，盗版必究。

【本文首发于唐霜的博客】

如果Tuple只接收一个参数的话，和ne原创内容，盗版必究。【转载请注明来源】w Type看上去没两样，但是，在兼容模【版权所有】唐霜 www.tangshuang.net【访问 www.tangshuang.net 获取更多精彩内容】式下，Tuple支持IfExists，而本文版权归作者所有，未经授权不得转载。本文版权归作者所有，未经授权不得转载。new Type不支持。这时，如果Tup【转载请注明来源】【版权所有，侵权必究】le末尾的IfExists会被兼容，也就【关注微信公众号：wwwtangshuangnet】转载请注明出处：www.tangshuang.net是说在参数个数校验时，会特殊处理，而ne本文作者：唐霜，转载请注明出处。【本文首发于唐霜的博客】w Type必须是强对应。下文会更详细介【关注微信公众号：wwwtangshuangnet】【原创内容，转载请注明出处】绍IfExists。

const SomeType = Tuple(String, Number, IfExists(Boolean))

注意，如果不是尾部的IfExists，它未经授权，禁止复制转载。【未经授权禁止转载】会被强制校验。

Range 域值

Range代表一个数字区间，要校验的值首【转载请注明来源】【原创内容，转载请注明出处】先得是数字，其次得是出于这个区间的值，区著作权归作者所有，禁止商业用途转载。【本文受版权保护】间包含传入的起始点和结束点。

它是一个函数，接收两个数字，第一个表示最【作者：唐霜】转载请注明出处：www.tangshuang.net小值，第二个表示最大值，返回一个容器

【访问 www.tangshuang.n原创内容，盗版必究。本文版权归作者所有，未经授权不得转载。et 获取更多精彩内容】

本文作者：唐霜，转载请注明出处。

【未经授权禁止转载】

最小值和最大值都必须是数字，如果不是数字【关注微信公众号：wwwtangshuangnet】著作权归作者所有，禁止商业用途转载。，会被分别转化为0和1

本文作者：唐霜，转载请注明出处。

【本文受版权保护】

【原创不易，请尊重版权】

最小值必须小于等于最大值，如果最小值大于转载请注明出处：www.tangshuang.net【未经授权禁止转载】最大值，会被强制转化为最大值相等数值后使本文版权归作者所有，未经授权不得转载。未经授权，禁止复制转载。用

本文作者：唐霜，转载请注明出处。

const RangeType = Range(0, 100)

上面的RangeType要求被校验的是数本文作者：唐霜，转载请注明出处。未经授权，禁止复制转载。字，且必须处于[0, 100]之间（包含本文作者：唐霜，转载请注明出处。本文作者：唐霜，转载请注明出处。0和100）。

自定义类型

你也可以写出自己的自定义类型，其实构建一未经授权，禁止复制转载。【转载请注明来源】个自定义类型非常简单，你可以查看Dict【本文受版权保护】本文作者：唐霜，转载请注明出处。的源码，它干了两件事，一是规定了函数传入【关注微信公众号：wwwtangshuangnet】本文版权归作者所有，未经授权不得转载。参数的限制，另一件事是创建一个容器，这个【作者：唐霜】著作权归作者所有，禁止商业用途转载。容器具有特殊的校验规则，并给它赋一个na【原创不易，请尊重版权】著作权归作者所有，禁止商业用途转载。me。例如，我现在要扩展出一个只允许包含【关注微信公众号：wwwtangshuangnet】原创内容，盗版必究。两个元素，且都是数字的数组的类型：

【转载请注明来源】【本文首发于唐霜的博客】著作权归作者所有，禁止商业用途转载。

function Position() {
  let type = List([Number, Number]).toBeStrict()
  type.name = 'Position'
}
const PositionType = Postion()

PositionType.assert([10, 100]) // ok
PositionType.assert([1, 1, 1]) // throw TypeError
PositionType.assert(['tomy', 10]) // throw TypeError

利用已有的各种素材，可以创建任何类型。

【未经授权禁止转载】【关注微信公众号：wwwtangshua本文作者：唐霜，转载请注明出处。【本文首发于唐霜的博客】ngnet】

Rule

规则是HelloType里面对一个值进行【访问 www.tangshuang.net 获取更多精彩内容】【原创不易，请尊重版权】校验时，真正用来作为对比基础的东西。也正【本文首发于唐霜的博客】【未经授权禁止转载】因为这样，规则是最千变万化的，前文已经说原创内容，盗版必究。【作者：唐霜】了哪些东西可以作为规则。不过显然，有穷的【作者：唐霜】【本文首发于唐霜的博客】列举还是无法满足所有需求，有的时候你需要【本文首发于唐霜的博客】【版权所有，侵权必究】自定义规则，这个时候你就需要用到Rule【访问 www.tangshuang.net 获取更多精彩内容】【本文首发于唐霜的博客】。

constructor

Rule是一个构造器，使用时你需要先引入【原创内容，转载请注明出处】【作者：唐霜】：

未经授权，禁止复制转载。【原创不易，请尊重版权】【原创内容，转载请注明出处】本文版权归作者所有，未经授权不得转载。

import { Rule } from 'hello-type'

它接收一个参数，这个参数是一个函数，函数【作者：唐霜】【访问 www.tangshuang.net 获取更多精彩内容】可以包含一个参数，这个参数就是要校验的值原创内容，盗版必究。【本文首发于唐霜的博客】。这个函数可以返回任意内容，但是，当你校本文作者：唐霜，转载请注明出处。【访问 www.tangshuang.net 获取更多精彩内容】验失败时，必须返回一个Error/Typ【本文首发于唐霜的博客】未经授权，禁止复制转载。eError实例，当HelloType发【访问 www.tangshuang.net 获取更多精彩内容】未经授权，禁止复制转载。现你返回的是Error的实例的时候，就认转载请注明出处：www.tangshuang.net【访问 www.tangshuang.net 获取更多精彩内容】为校验失败，并抛出错误：

const MyRule = new Rule(function(value) {
  if (typeof value !== 'object') {
    return new TypeError('%arg is not an object')
  }
})

非常简单。不过它也可以接收两个参数，第一未经授权，禁止复制转载。【原创内容，转载请注明出处】个参数可以是一个字符串，用来给这个Rul本文作者：唐霜，转载请注明出处。【访问 www.tangshuang.net 获取更多精彩内容】e命名：

const MyRule = new Rule('ObjectRule', function(value) {
  if (typeof value !== 'object') {
    return new TypeError('%arg is not an object')
  }
})
MyRule.name // ObjectRule

=== 注意：以下内容有点危险 ===

【未经授权禁止转载】著作权归作者所有，禁止商业用途转载。【转载请注明来源】

Rule构造器还可以接收第三个参数，但是本文版权归作者所有，未经授权不得转载。【本文首发于唐霜的博客】这个参数有点危险，请谨慎使用。第三个参数【作者：唐霜】【作者：唐霜】用来覆盖当前属性的值。它仅对对象属性、数【访问 www.tangshuang.net 获取更多精彩内容】【原创不易，请尊重版权】组元素生效。

const MyRule = new Rule('ObjectRule', function(value) {
  if (typeof value !== 'object') {
    return new TypeError('%arg is not an object')
  }
}, function(error, prop, target) {
  if (error) {
    target[prop] = {}
  }
})

上面这段代码创建了一个rule，它会检查【原创不易，请尊重版权】本文版权归作者所有，未经授权不得转载。一个值是否typeof为object，如【未经授权禁止转载】【本文首发于唐霜的博客】果不是就抛出错误，但是如果当前检查的值是著作权归作者所有，禁止商业用途转载。【本文首发于唐霜的博客】一个对象的属性，或者一个数组的元素，它还转载请注明出处：www.tangshuang.net【版权所有】唐霜 www.tangshuang.net会继执行第三个参数的函数，而不会立即终止【关注微信公众号：wwwtangshuangnet】转载请注明出处：www.tangshuang.net进程，执行完第三个参数的函数之后，再回到未经授权，禁止复制转载。【转载请注明来源】第二个函数参数重新进行校验，如果校验通过未经授权，禁止复制转载。【本文受版权保护】了，则不会报任何错。

【本文首发于唐霜的博客】本文作者：唐霜，转载请注明出处。转载请注明出处：www.tangshua【原创不易，请尊重版权】未经授权，禁止复制转载。ng.net

第三个函数有三个参数

【原创内容，转载请注明出处】本文版权归作者所有，未经授权不得转载。著作权归作者所有，禁止商业用途转载。

error 第二个函数的返回值，看你自己【访问 www.tangshuang.net 获取更多精彩内容】【版权所有】唐霜 www.tangshuang.net在第二个函数中怎么返回

本文版权归作者所有，未经授权不得转载。

【原创内容，转载请注明出处】

本文作者：唐霜，转载请注明出处。

prop 正在检查哪一个对象的什么属性

【关注微信公众号：wwwtangshua【本文受版权保护】未经授权，禁止复制转载。ngnet】

著作权归作者所有，禁止商业用途转载。

target 正在检查哪一个对象

著作权归作者所有，禁止商业用途转载。

【本文首发于唐霜的博客】

但是你应该注意到，在第三个函数中，我使用著作权归作者所有，禁止商业用途转载。原创内容，盗版必究。了target[prop] = {}，直本文作者：唐霜，转载请注明出处。【转载请注明来源】接修改了原始数据中的内容，这一点你要千万原创内容，盗版必究。【版权所有】唐霜 www.tangshuang.net小心，这个操作修改了原始值，因此你一定要【版权所有】唐霜 www.tangshuang.net【版权所有，侵权必究】在知道发生了什么的情况下使用。

著作权归作者所有，禁止商业用途转载。本文版权归作者所有，未经授权不得转载。【作者：唐霜】

Null、Undefined、Any

在最前面的章节里我已经介绍到了这Null【作者：唐霜】本文作者：唐霜，转载请注明出处。、Undefined、Any这三个被扩展【本文首发于唐霜的博客】原创内容，盗版必究。出来的原型。

Null

要校验的值必须是null。

【原创内容，转载请注明出处】本文版权归作者所有，未经授权不得转载。转载请注明出处：www.tangshua【转载请注明来源】【原创不易，请尊重版权】ng.net

Undefined

要校验的值必须是undefined。

【作者：唐霜】【本文受版权保护】

Any

本文作者：唐霜，转载请注明出处。著作权归作者所有，禁止商业用途转载。

要校验的值可以是任何类型。

本文版权归作者所有，未经授权不得转载。原创内容，盗版必究。【原创不易，请尊重版权】【本文首发于唐霜的博客】

Numeric

本文作者：唐霜，转载请注明出处。【本文首发于唐霜的博客】【原创内容，转载请注明出处】

内置规则

我在HelloType中内置了几种规则，转载请注明出处：www.tangshuang.net【访问 www.tangshuang.net 获取更多精彩内容】把常见的一些情况考虑进去，当然，考虑的不未经授权，禁止复制转载。转载请注明出处：www.tangshuang.net够全面，如果你有认为需要改进的地方，可以【版权所有，侵权必究】【本文受版权保护】给我提出需求，我可以根据情况，把你提出的【本文首发于唐霜的博客】【原创不易，请尊重版权】规则内置进去。

【转载请注明来源】【关注微信公众号：wwwtangshua未经授权，禁止复制转载。【本文首发于唐霜的博客】ngnet】未经授权，禁止复制转载。

IfExists

这一些情况下，你希望有些值是可选的，比如【版权所有，侵权必究】【本文首发于唐霜的博客】一个对象的某个属性，你希望如果这个属性存【原创不易，请尊重版权】【本文受版权保护】在，就校验它，如果不存在，就直接略过。数著作权归作者所有，禁止商业用途转载。【关注微信公众号：wwwtangshuangnet】组也是一样，你希望一个数组如果是空数组，【访问 www.tangshuang.net 获取更多精彩内容】未经授权，禁止复制转载。就直接略过，如果这个数组有元素，那么要求【未经授权禁止转载】本文版权归作者所有，未经授权不得转载。它每个元素都是一个字符串。这样的需求比较【关注微信公众号：wwwtangshuangnet】著作权归作者所有，禁止商业用途转载。常见。

【访问 www.tangshuang.n【访问 www.tangshuang.net 获取更多精彩内容】【转载请注明来源】et 获取更多精彩内容】转载请注明出处：www.tangshua【作者：唐霜】【转载请注明来源】ng.net原创内容，盗版必究。

那么怎么做到呢？就要借助IfExists原创内容，盗版必究。【未经授权禁止转载】。

IfExists是一个函数，接收一个规则【关注微信公众号：wwwtangshuangnet】【本文受版权保护】作为参数，返回一个规则

【访问 www.tangshuang.n【转载请注明来源】【原创不易，请尊重版权】et 获取更多精彩内容】

【本文首发于唐霜的博客】

原创内容，盗版必究。

当要校验的值存在时，它必须满足IfExi【未经授权禁止转载】未经授权，禁止复制转载。sts参数中的规则

著作权归作者所有，禁止商业用途转载。

转载请注明出处：www.tangshua【原创不易，请尊重版权】【关注微信公众号：wwwtangshuangnet】ng.net

如果不存在，则直接忽略

本文版权归作者所有，未经授权不得转载。

【原创不易，请尊重版权】

严格模式下IfExists失效，被校验值本文作者：唐霜，转载请注明出处。【本文受版权保护】必须满足IfExists接收的第一个参数【未经授权禁止转载】【本文受版权保护】中的规则

【转载请注明来源】

【未经授权禁止转载】

const SomeType = Dict({
  name: String,
  age: IfExists(Number)
})

严格模式下的时候，要特别注意，IfExi未经授权，禁止复制转载。未经授权，禁止复制转载。sts会失效，因此，如果你用SomeTy转载请注明出处：www.tangshuang.net【关注微信公众号：wwwtangshuangnet】pe的严格模式，age必须是一个数字。

【本文受版权保护】转载请注明出处：www.tangshua【原创不易，请尊重版权】原创内容，盗版必究。ng.net【本文受版权保护】

【本文首发于唐霜的博客】本文版权归作者所有，未经授权不得转载。

const SomeType = Tuple(String, IfExists(String), Number, IfExists(Boolean), IfExists(Boolean))

上面有三个IfExists，但只有末尾两【转载请注明来源】【原创不易，请尊重版权】个会生效，第一个IfExists会被严格著作权归作者所有，禁止商业用途转载。转载请注明出处：www.tangshuang.net校验。

InstanceOf

InstanceOf是一个函数，接收一个本文作者：唐霜，转载请注明出处。本文版权归作者所有，未经授权不得转载。参数，这个参数必须是一个构造器，返回一个【本文受版权保护】本文版权归作者所有，未经授权不得转载。规则

【本文受版权保护】

本文版权归作者所有，未经授权不得转载。

在HelloType中String，Nu著作权归作者所有，禁止商业用途转载。【转载请注明来源】mber，Boolean，Object都【未经授权禁止转载】未经授权，禁止复制转载。做了强制，因此，当你想要判断一个值是否是【原创内容，转载请注明出处】【本文受版权保护】new String出来的怎么办呢？这个著作权归作者所有，禁止商业用途转载。未经授权，禁止复制转载。时候就得借助InstanceOf：

【未经授权禁止转载】本文版权归作者所有，未经授权不得转载。【原创内容，转载请注明出处】【原创内容，转载请注明出处】

const StringType = new Type(InstanceOf(String))
StringType.assert('xxx') // throw TypeError
StringType.assert(new String('xxx')) // ok

由于HelloType内部本身就会去校验【未经授权禁止转载】【原创不易，请尊重版权】一个对象是否是给出的规则类的一个实例，所未经授权，禁止复制转载。【原创内容，转载请注明出处】以，在校验是否是实例的时候其实不需要专门转载请注明出处：www.tangshuang.net转载请注明出处：www.tangshuang.net使用InstanceOf:

转载请注明出处：www.tangshua本文版权归作者所有，未经授权不得转载。本文版权归作者所有，未经授权不得转载。ng.net未经授权，禁止复制转载。【本文首发于唐霜的博客】【本文受版权保护】

const ins = new MyClass()

const MyClassType = new Type(MyClass)

MyClassType.assert(ins) // ok

之所以提供InstanceOf规则，是用【版权所有】唐霜 www.tangshuang.net转载请注明出处：www.tangshuang.net来校验直接属于某个类的实例的情况。例如F【作者：唐霜】著作权归作者所有，禁止商业用途转载。ile的实例，同时也是Blob的实例，但【版权所有】唐霜 www.tangshuang.net未经授权，禁止复制转载。是，在使用InstanceOf规则时，只本文作者：唐霜，转载请注明出处。【原创不易，请尊重版权】会通过File，而不通过Blob。另外，【本文受版权保护】【作者：唐霜】InstanceOf的最合理使用场景是，【访问 www.tangshuang.net 获取更多精彩内容】【本文首发于唐霜的博客】避免直接校验js内置的构造器，例如Num著作权归作者所有，禁止商业用途转载。本文版权归作者所有，未经授权不得转载。ber，new Type(Number)只会校验真实的数字，而无法校验num =原创内容，盗版必究。【转载请注明来源】 new Number(10)，这个时候未经授权，禁止复制转载。【本文受版权保护】就必须new Type(InstanceOf(Number))。

转载请注明出处：www.tangshua【未经授权禁止转载】【原创不易，请尊重版权】ng.net原创内容，盗版必究。【本文受版权保护】

Equal

在HelloType的校验中，虽然会先校【版权所有，侵权必究】【本文首发于唐霜的博客】验一个值是否与规定的值相等，然后再考虑其【版权所有】唐霜 www.tangshuang.net本文版权归作者所有，未经授权不得转载。他校验规则。而String，Number转载请注明出处：www.tangshuang.net【关注微信公众号：wwwtangshuangnet】，Boolean，Object都被做了强【原创不易，请尊重版权】【作者：唐霜】制，因此，如果你这样做：

【本文首发于唐霜的博客】【访问 www.tangshuang.n【关注微信公众号：wwwtangshuangnet】【原创内容，转载请注明出处】et 获取更多精彩内容】

const SomeType = new Type(String)
SomeType.assert(String) // throw TypeError

只会得到一个错误，所以，在这种情况下，默【未经授权禁止转载】【访问 www.tangshuang.net 获取更多精彩内容】认的相等规则失效了，这个时候就需要借助E转载请注明出处：www.tangshuang.net【原创不易，请尊重版权】qual：

const SomeType = new Type(Equal(String))
SomeType.assert(String) // ok

IfNotMatch

当一个值不符合你的预期的时候，你想给它一【本文首发于唐霜的博客】未经授权，禁止复制转载。个默认值怎么办呢？例如，你希望api返回转载请注明出处：www.tangshuang.net【版权所有，侵权必究】的children是一个数组，但是api本文作者：唐霜，转载请注明出处。【转载请注明来源】返回给你null，你想把它调整为一个空数未经授权，禁止复制转载。【版权所有，侵权必究】组，怎么办呢？用IfNotMatch可以【版权所有，侵权必究】【版权所有】唐霜 www.tangshuang.net办到。

IfNotMatch是一个函数，接收两个【原创不易，请尊重版权】原创内容，盗版必究。参数，

【未经授权禁止转载】

【原创不易，请尊重版权】

第一个参数rule是要检查的类型规则，

原创内容，盗版必究。

【转载请注明来源】

【原创不易，请尊重版权】

第二个参数defaultValue是在不【原创内容，转载请注明出处】【本文受版权保护】通过校验的情况下用什么值覆盖，可选

著作权归作者所有，禁止商业用途转载。

未经授权，禁止复制转载。

第三个参数，可选，一个函数，接收原始值和【本文受版权保护】本文作者：唐霜，转载请注明出处。你传的defaultValue作为参数，【版权所有，侵权必究】原创内容，盗版必究。返回值将替换该属性的值

本文作者：唐霜，转载请注明出处。

原创内容，盗版必究。

const SomeType = Dict({
  code: Number,
  data: {
    name: String,
    children: IfNotMatch(List([Object]), [])
  },
})

虽然上面的这句话很像IfExists，但原创内容，盗版必究。著作权归作者所有，禁止商业用途转载。是并不是，IfExists是允许chil【本文首发于唐霜的博客】【本文受版权保护】dren不存在，而IfNotMatch要【未经授权禁止转载】【未经授权禁止转载】求children必须存在，如果不存在，原创内容，盗版必究。【原创不易，请尊重版权】或者说它不满足List([Object]【关注微信公众号：wwwtangshuangnet】【本文受版权保护】)，就会用一个空数组去代替。

第三个参数是一个函数，用来动态计算值并返本文作者：唐霜，转载请注明出处。【原创不易，请尊重版权】回一个值作为新值赋值给原始数据。

著作权归作者所有，禁止商业用途转载。未经授权，禁止复制转载。

const SomeType = Dict({
  code: Number,
  data: {
    name: String,
    children: IfNotMatch(List([Object]), (value) => {
      if (!Array.isArray(value)) {
        return []
      }
      else {
        return value.map(item => item && typeof item === 'object' ? item : {})
      }
    })
  },
})

前面说过Rule的第三个参数，IfNot转载请注明出处：www.tangshuang.net【版权所有，侵权必究】Match就用了这第三个危险的参数，它会【未经授权禁止转载】本文作者：唐霜，转载请注明出处。修改你的原始值，因此在使用的时候要特别小【转载请注明来源】【本文受版权保护】心。举个例子，你不能在使用trace的场未经授权，禁止复制转载。【作者：唐霜】景下使用IfNotMatch，因为tra原创内容，盗版必究。【作者：唐霜】ce会异步执行代码，如果你这个时候使用I未经授权，禁止复制转载。【原创内容，转载请注明出处】fNotMatch的第二个参数defau【未经授权禁止转载】原创内容，盗版必究。ltValue去覆盖，你会发现，覆盖动作本文版权归作者所有，未经授权不得转载。原创内容，盗版必究。位于你整个程序时序的最后，这个时候，bu原创内容，盗版必究。【本文受版权保护】g可能已经产生了。最大的建议，就是尽可能不要用IfNotM本文版权归作者所有，未经授权不得转载。【未经授权禁止转载】atch。

IfExistsNotMatch

相当于IfExists和IfNotMat【版权所有，侵权必究】【版权所有】唐霜 www.tangshuang.netch的组合。当一个属性不存在时，直接忽视【版权所有】唐霜 www.tangshuang.net著作权归作者所有，禁止商业用途转载。这条规则，不进行校验。而如果存在的情况下【关注微信公众号：wwwtangshuangnet】未经授权，禁止复制转载。，就要进行校验，同时，如果校验失败，用新【原创不易，请尊重版权】【转载请注明来源】值去替代原始值。

IfExistsNotMatch是一个函【原创内容，转载请注明出处】本文作者：唐霜，转载请注明出处。数，接收两个参数，

【本文受版权保护】

【转载请注明来源】

【未经授权禁止转载】

第一个参数rule是要检查的类型规则，

原创内容，盗版必究。

著作权归作者所有，禁止商业用途转载。

第二个参数defaultValue是在不【访问 www.tangshuang.net 获取更多精彩内容】未经授权，禁止复制转载。通过校验的情况下用什么值覆盖，可选

本文版权归作者所有，未经授权不得转载。

【关注微信公众号：wwwtangshua本文作者：唐霜，转载请注明出处。【本文受版权保护】ngnet】

第三个参数，可选，一个函数，接收原始值和原创内容，盗版必究。【关注微信公众号：wwwtangshuangnet】你传的defaultValue作为参数，【转载请注明来源】【未经授权禁止转载】返回值将替换该属性的值

【作者：唐霜】

【未经授权禁止转载】

【本文首发于唐霜的博客】

const SomeType = Dict({
  code: Number,
  data: {
    name: String,
    children: IfExistsNotMatch(List([Object]), [])
  },
})

当children不存在时，就不进行校验，如果存在时，进行【原创不易，请尊重版权】【原创内容，转载请注明出处】校验，如果校验结果为失败，那么用一个空数【原创不易，请尊重版权】【原创内容，转载请注明出处】组作为值赋给children。这对某些api返回的数据有帮助，比如某本文版权归作者所有，未经授权不得转载。转载请注明出处：www.tangshuang.net些api，根据你传入的某个scope参数未经授权，禁止复制转载。本文作者：唐霜，转载请注明出处。，返回对应的字段给你，不在你传的scop【版权所有，侵权必究】【转载请注明来源】e中的字段不会返回，因此，使用IfExi【本文首发于唐霜的博客】【本文首发于唐霜的博客】sts校验比较合理。

转载请注明出处：www.tangshua【本文受版权保护】著作权归作者所有，禁止商业用途转载。ng.net本文作者：唐霜，转载请注明出处。本文作者：唐霜，转载请注明出处。

Lambda

这个规则非常微妙，虽然我不推荐你使用它，【转载请注明来源】著作权归作者所有，禁止商业用途转载。但是我希望你知道它的思想，这样你可以更好【本文首发于唐霜的博客】【版权所有】唐霜 www.tangshuang.net的使用HelloType。Lambda会【转载请注明来源】著作权归作者所有，禁止商业用途转载。检查当前值是否是一个函数，如果是函数的话【访问 www.tangshuang.net 获取更多精彩内容】原创内容，盗版必究。，会重写这个函数，并且用输入和输出规则进【作者：唐霜】【版权所有，侵权必究】行校验。

本文作者：唐霜，转载请注明出处。转载请注明出处：www.tangshua原创内容，盗版必究。未经授权，禁止复制转载。ng.net【访问 www.tangshuang.n【未经授权禁止转载】【关注微信公众号：wwwtangshuangnet】et 获取更多精彩内容】

Lambda是一个函数，接收两个参数

【本文首发于唐霜的博客】

【本文受版权保护】

第一个参数是输入值的规则，如果你的函数要【原创内容，转载请注明出处】转载请注明出处：www.tangshuang.net求输入多个值，要用Tuple

原创内容，盗版必究。

【本文首发于唐霜的博客】

第二个参数是输出值的规则

转载请注明出处：www.tangshua未经授权，禁止复制转载。【原创内容，转载请注明出处】ng.net

【转载请注明来源】

原创内容，盗版必究。

它要求值首先得是一个函数，其次它在运行过未经授权，禁止复制转载。本文作者：唐霜，转载请注明出处。程中，输入输出都必须符合要求

转载请注明出处：www.tangshua本文作者：唐霜，转载请注明出处。【原创内容，转载请注明出处】ng.net

本文作者：唐霜，转载请注明出处。

著作权归作者所有，禁止商业用途转载。

如果任何一点校验失败，都会抛出错误，函数转载请注明出处：www.tangshuang.net【未经授权禁止转载】的执行被中断，你得不到任何结果

【访问 www.tangshuang.n转载请注明出处：www.tangshuang.net【本文受版权保护】et 获取更多精彩内容】

未经授权，禁止复制转载。

本文版权归作者所有，未经授权不得转载。

只对对象属性、数组元素生效

【未经授权禁止转载】

本文作者：唐霜，转载请注明出处。

const SomeType = Dict({
  fn: Lambda(Tuple(String, Number), Object),
})

这个不能多讲，毕竟它是一个比较危险容易出著作权归作者所有，禁止商业用途转载。本文作者：唐霜，转载请注明出处。bug的规则，你应该学习它的思想，去gi【原创不易，请尊重版权】【转载请注明来源】thub上读它的源码。

著作权归作者所有，禁止商业用途转载。原创内容，盗版必究。【未经授权禁止转载】原创内容，盗版必究。

Validate：自定义消息

这个规则更适合用来做自定义消息，它非常有【版权所有】唐霜 www.tangshuang.net【访问 www.tangshuang.net 获取更多精彩内容】利于降级HelloType的概念，让基础【本文受版权保护】本文版权归作者所有，未经授权不得转载。开发者不必深入了解HelloType的理【作者：唐霜】原创内容，盗版必究。念，从业务中逐渐过度HelloType的【本文首发于唐霜的博客】【转载请注明来源】使用方法，我们来看一个例子：

原创内容，盗版必究。【原创不易，请尊重版权】原创内容，盗版必究。

let SomeType = Dict({
  name: Validate(String, '名字必须为字符串'),
  child: Validate(Any, 'child字段必须填写'),
  age: Validate(value => typeof value === 'number' && value > 10, '年龄必须大于10'),
})

上面规定了一个对象的三个字段的类型，在具【原创不易，请尊重版权】著作权归作者所有，禁止商业用途转载。体业务中，这个对象可能是表单要提交的对象著作权归作者所有，禁止商业用途转载。【访问 www.tangshuang.net 获取更多精彩内容】，利用这种方式，可以很好的做表单检查：

function onSubmit() {
  let data = this.formdata
  let error = SomeType.catch(data)
  if (error) {
    this.toast.error(error.message)
  }
  // ...
}

上面这段绿色的代码进行了数据检查，当用户未经授权，禁止复制转载。【原创内容，转载请注明出处】点击提交按钮的时候，SomeType检查【本文受版权保护】【本文首发于唐霜的博客】数据，并返回错误提示（只能提示到出错的第【版权所有】唐霜 www.tangshuang.net著作权归作者所有，禁止商业用途转载。一条数据，当用户修改之后，再点提交，如果本文作者：唐霜，转载请注明出处。转载请注明出处：www.tangshuang.net还有错误，又会提示）。

未经授权，禁止复制转载。原创内容，盗版必究。【作者：唐霜】

Validate函数的参数如下：

rule: 可以是任何的rule，也可以【版权所有】唐霜 www.tangshuang.net【访问 www.tangshuang.net 获取更多精彩内容】是一个函数，如果是一个函数，必须返回tr【未经授权禁止转载】本文作者：唐霜，转载请注明出处。ue/false，true表示校验通过，本文版权归作者所有，未经授权不得转载。【版权所有】唐霜 www.tangshuang.netfalse表示不通过

本文版权归作者所有，未经授权不得转载。

message：当校验不通过时，给出什么未经授权，禁止复制转载。【版权所有，侵权必究】提示，它可以是一个函数，value =&未经授权，禁止复制转载。未经授权，禁止复制转载。gt; String，之所以提供函数形式本文版权归作者所有，未经授权不得转载。本文作者：唐霜，转载请注明出处。，主要是开发者可以在这个位置获取用户输入本文版权归作者所有，未经授权不得转载。【原创不易，请尊重版权】的值，这样有利于进一步优化消息的内容。

【本文受版权保护】

未经授权，禁止复制转载。

Determine：条件选择

这个规则主要用来根据当前属性所在的对象进【原创不易，请尊重版权】本文作者：唐霜，转载请注明出处。行条件选择，根据对象上其他属性的判断来确本文版权归作者所有，未经授权不得转载。转载请注明出处：www.tangshuang.net定当前这个属性应该是什么类型。比如，当前【访问 www.tangshuang.net 获取更多精彩内容】【转载请注明来源】这个对象是一个person，而它有一个属未经授权，禁止复制转载。原创内容，盗版必究。性叫mustache（胡子），显然，女人【作者：唐霜】【转载请注明来源】是不可能有胡子的，因此，要决定musta【版权所有】唐霜 www.tangshuang.net【本文受版权保护】che的值的类型，需要依赖于对性别的检查【未经授权禁止转载】【原创内容，转载请注明出处】。那么这种情况下，就可以使用Determ【版权所有】唐霜 www.tangshuang.net【版权所有】唐霜 www.tangshuang.netine来做：

const PersonType = Dict({
  name: String,
  isMale: Boolean,
  // data type check based on person.isMale
  mustache: Determine(function(person) {
    if (person.isMale) {
      return Number
    }
    else {
      return Null
    }
  }),
})

本文版权归作者所有，未经授权不得转载。【原创内容，转载请注明出处】本文作者：唐霜，转载请注明出处。【未经授权禁止转载】

Determine函数的具体参数如下：

factory: Determine仅接【版权所有】唐霜 www.tangshuang.net【版权所有，侵权必究】收一个函数作为参数，这个函数接收参数如下
- object: factory仅接收一个本文版权归作者所有，未经授权不得转载。本文作者：唐霜，转载请注明出处。对象，这个对象是这个属性所在的对象的原始【关注微信公众号：wwwtangshuangnet】【转载请注明来源】引用，因此，绝对不能在factory内修改objec【版权所有，侵权必究】本文作者：唐霜，转载请注明出处。t的属性值
- @return factory必须返回一【版权所有，侵权必究】未经授权，禁止复制转载。个用于决定当前属性是什么数据类型的规则

【转载请注明来源】

@return Determine返回一【原创内容，转载请注明出处】原创内容，盗版必究。个Rule的实例

未经授权，禁止复制转载。

Async

Async规则也是一个函数，它生成一个特著作权归作者所有，禁止商业用途转载。【原创内容，转载请注明出处】殊的规则，这个规则在默认情况下永远返回t原创内容，盗版必究。【转载请注明来源】rue，即不会造成任何校验错误。但是你需【原创内容，转载请注明出处】【版权所有】唐霜 www.tangshuang.net要向它传一个函数，这个函数里面进行异步操【版权所有】唐霜 www.tangshuang.net未经授权，禁止复制转载。作，通过返回Promise来返回一个规则【本文首发于唐霜的博客】未经授权，禁止复制转载。，当Promise resolved之后【版权所有】唐霜 www.tangshuang.net著作权归作者所有，禁止商业用途转载。，这个返回的规则会替代原有规则，成为新规著作权归作者所有，禁止商业用途转载。【本文受版权保护】则。

【关注微信公众号：wwwtangshua【原创不易，请尊重版权】本文版权归作者所有，未经授权不得转载。ngnet】【原创不易，请尊重版权】未经授权，禁止复制转载。【转载请注明来源】

这个规则适合用在一些需要等待加载的情景：

【本文受版权保护】原创内容，盗版必究。转载请注明出处：www.tangshua【未经授权禁止转载】【作者：唐霜】ng.net

const SomeType = new Type({
  test: Async(function() {
    return new Promise((resolve) => {
      setTimeout(() => resolve(Number), 200)
    })
  }),
})

SomeType.assert({ text: '10' }) // 不会报错，因为SomeType的真正规则还没有加载出来
setTimeout(() => {
  SomeType.assert({ test: '10' }) // 会报错，因为SomeType的test的规则已经被设置为Number
}, 300)

上面这段代码，很好演示了在异步校验场景的著作权归作者所有，禁止商业用途转载。【关注微信公众号：wwwtangshuangnet】应用。

原创内容，盗版必究。转载请注明出处：www.tangshua【本文受版权保护】【转载请注明来源】ng.net【关注微信公众号：wwwtangshua著作权归作者所有，禁止商业用途转载。转载请注明出处：www.tangshuang.netngnet】转载请注明出处：www.tangshua【作者：唐霜】【本文首发于唐霜的博客】ng.net

ShouldMatch：同时满足多个

在一些特定环境下，你需要一个规则，让当前本文作者：唐霜，转载请注明出处。本文作者：唐霜，转载请注明出处。值同时满足多个检查规则才算通过校验。感觉【关注微信公众号：wwwtangshuangnet】原创内容，盗版必究。上，它和Enum是相对的一个规则，Enu转载请注明出处：www.tangshuang.net著作权归作者所有，禁止商业用途转载。m要求只需要满足其中之一，而Should原创内容，盗版必究。【版权所有，侵权必究】Match要求必须全部满足。

【访问 www.tangshuang.n【访问 www.tangshuang.net 获取更多精彩内容】【作者：唐霜】et 获取更多精彩内容】未经授权，禁止复制转载。

ShouldMatch函数的具体参数：

【关注微信公众号：wwwtangshua本文版权归作者所有，未经授权不得转载。原创内容，盗版必究。ngnet】原创内容，盗版必究。

…rules: 规则列表，你【关注微信公众号：wwwtangshuangnet】【关注微信公众号：wwwtangshuangnet】可以传入任意多个规则，这些规则按照顺序被未经授权，禁止复制转载。【关注微信公众号：wwwtangshuangnet】检查，只有全部通过检查之后，Should本文作者：唐霜，转载请注明出处。【本文受版权保护】Match才算通过

【未经授权禁止转载】

【访问 www.tangshuang.n转载请注明出处：www.tangshuang.net转载请注明出处：www.tangshuang.netet 获取更多精彩内容】

const SomeType = Dict({
  value: ShouldMatch(
    Validate(Number, 'it should be a number'),
    Validate(value => value === parseInt(value, 10), 'it should be a int number')
   )
})

上面这个例子非常好的解释了它的使用场景。【访问 www.tangshuang.net 获取更多精彩内容】【本文首发于唐霜的博客】Validate规则只能规定一个mess【本文首发于唐霜的博客】原创内容，盗版必究。age，但是，有的时候，你需要针对不同的本文版权归作者所有，未经授权不得转载。著作权归作者所有，禁止商业用途转载。检查结果给出不同的message，这个时【未经授权禁止转载】【本文首发于唐霜的博客】候，可以将Validate拆分，并配合S【访问 www.tangshuang.net 获取更多精彩内容】本文作者：唐霜，转载请注明出处。houldMatch来用，就可以非常方便【版权所有】唐霜 www.tangshuang.net【本文首发于唐霜的博客】的实现这个目的。

DetermineExists

这个规则生成器的厉害之处在于，可以通过一原创内容，盗版必究。本文版权归作者所有，未经授权不得转载。个条件去决定该属性是否可以不存在。听上去原创内容，盗版必究。【原创不易，请尊重版权】，逻辑是反的，但是事实时，在某些情况下，本文版权归作者所有，未经授权不得转载。【访问 www.tangshuang.net 获取更多精彩内容】你希望通过一个条件判断来决定这个属性是不转载请注明出处：www.tangshuang.net转载请注明出处：www.tangshuang.net是存在，如果存在的情况下会使用某个规则。【版权所有】唐霜 www.tangshuang.net【访问 www.tangshuang.net 获取更多精彩内容】它的用法如下：

本文版权归作者所有，未经授权不得转载。【作者：唐霜】【本文受版权保护】【作者：唐霜】

const SomeType = Dict({
  name: String,
  age: Number,
  knowledge: DetermineExists(data => data.age > 10, KnowledgeType), // 当data.age <= 10时，knowledge属性可以不存在
})

它的使用方法和IfExists极其相似，著作权归作者所有，禁止商业用途转载。【作者：唐霜】都是只有在该属性存在的情况下才会运用对应【访问 www.tangshuang.net 获取更多精彩内容】【原创不易，请尊重版权】的type去做数据检查。但是，Deter著作权归作者所有，禁止商业用途转载。本文版权归作者所有，未经授权不得转载。mineExists会在决定这个属性是否转载请注明出处：www.tangshuang.net著作权归作者所有，禁止商业用途转载。可以不存在时，多加来一层。

【本文受版权保护】转载请注明出处：www.tangshua【作者：唐霜】【关注微信公众号：wwwtangshuangnet】ng.net【本文受版权保护】原创内容，盗版必究。

determine 函数，接收当前对象，原创内容，盗版必究。未经授权，禁止复制转载。返回boolean，如果为true表示该转载请注明出处：www.tangshuang.net本文作者：唐霜，转载请注明出处。属性必须存在，且用第二个参数去进行类型检本文版权归作者所有，未经授权不得转载。【转载请注明来源】查，如果为false表示该属性可以不存在未经授权，禁止复制转载。转载请注明出处：www.tangshuang.net，但是在存在的情况下，也得遵守第二个参数著作权归作者所有，禁止商业用途转载。【版权所有】唐霜 www.tangshuang.net的类型规则

转载请注明出处：www.tangshua原创内容，盗版必究。【本文首发于唐霜的博客】ng.net

【作者：唐霜】

type 在该属性存在的情况下的类型规则

【未经授权禁止转载】

转载请注明出处：www.tangshua转载请注明出处：www.tangshuang.net【转载请注明来源】ng.net

这个方法在一些特别的情况下具有非常重要的本文作者：唐霜，转载请注明出处。著作权归作者所有，禁止商业用途转载。作用，例如，有些接口的某些字段，在接口返【原创不易，请尊重版权】转载请注明出处：www.tangshuang.net回的对象为某种类型时，有些字段不存在，而【版权所有，侵权必究】著作权归作者所有，禁止商业用途转载。另外一些字段只有在该对象为特定类型是才会【本文首发于唐霜的博客】【版权所有，侵权必究】存在，这是就可以用Determine来规本文作者：唐霜，转载请注明出处。【关注微信公众号：wwwtangshuangnet】定它的规则。

规则嵌套

【关注微信公众号：wwwtangshua【原创内容，转载请注明出处】【原创内容，转载请注明出处】ngnet】本文作者：唐霜，转载请注明出处。原创内容，盗版必究。【转载请注明来源】

const SomeType = new Type({
  color: IfExists(Enum('blue', 'red', 'yellow')),
})

如果color存在的话，就必须为红蓝黄中未经授权，禁止复制转载。转载请注明出处：www.tangshuang.net的一个，否则验证不通过。再比如：

【本文首发于唐霜的博客】本文作者：唐霜，转载请注明出处。著作权归作者所有，禁止商业用途转载。

const SomeType = new Type({
  color: IfExists(Validate(String, '必须是字符串')),
})

这样也是一种形式。

未经授权，禁止复制转载。本文版权归作者所有，未经授权不得转载。本文版权归作者所有，未经授权不得转载。

但是，IfNotMatch和IfExists【原创不易，请尊重版权】转载请注明出处：www.tangshuang.netNotMatch不能被嵌套使用，一定、必【未经授权禁止转载】【原创内容，转载请注明出处】须、立刻记住这点，因为嵌套不会得到你想要著作权归作者所有，禁止商业用途转载。本文版权归作者所有，未经授权不得转载。的结果。当然，IfExistsNotMa未经授权，禁止复制转载。未经授权，禁止复制转载。tch本身就是为了解这个问题出现的，总之本文作者：唐霜，转载请注明出处。本文作者：唐霜，转载请注明出处。，你不能在其他规则中嵌套这两个规则，否则【原创内容，转载请注明出处】【未经授权禁止转载】bug出现的时候你可能都找不到原因。

【访问 www.tangshuang.n本文版权归作者所有，未经授权不得转载。本文版权归作者所有，未经授权不得转载。et 获取更多精彩内容】【本文首发于唐霜的博客】著作权归作者所有，禁止商业用途转载。

// 错误的代码示例
const SomeType = new Type({
  color: IfExists(IfNotMatch(String, '#ffffff')),
})

这种情况，应该使用IfExistsNot【访问 www.tangshuang.net 获取更多精彩内容】本文版权归作者所有，未经授权不得转载。Match替代。而类似Validate(IfNotMatch(String, '#ffffff'), '必须是色值')这样的校验规则没有任何意义，而且，也得不【本文受版权保护】【关注微信公众号：wwwtangshuangnet】到预期的结果。

【原创不易，请尊重版权】本文作者：唐霜，转载请注明出处。

HelloType辅助器

前面的内容基本上已经囊括了HelloTy转载请注明出处：www.tangshuang.net【版权所有，侵权必究】pe类型检查的所有内容，你可以利用上面的【访问 www.tangshuang.net 获取更多精彩内容】未经授权，禁止复制转载。内容编程了。但是有一个问题，上面的使用方本文版权归作者所有，未经授权不得转载。【版权所有，侵权必究】法太过分散，如果你要进行代码升级的话，非本文作者：唐霜，转载请注明出处。【转载请注明来源】常麻烦。因此，我提供了一堆辅助器方便统一【转载请注明来源】本文作者：唐霜，转载请注明出处。代码风格，这样，在用编辑器进行全局搜索时本文版权归作者所有，未经授权不得转载。本文作者：唐霜，转载请注明出处。，就很有用，可以快速定位到代码位置。

所有辅助器都以HelloType打头，例本文版权归作者所有，未经授权不得转载。本文作者：唐霜，转载请注明出处。如：

【未经授权禁止转载】原创内容，盗版必究。未经授权，禁止复制转载。

HelloType.expect(obj).to.match(SomeType)

这样，你搜索HelloType.expe【本文首发于唐霜的博客】转载请注明出处：www.tangshuang.netct，就可以找到所有断言代码了。

【关注微信公众号：wwwtangshua本文作者：唐霜，转载请注明出处。原创内容，盗版必究。ngnet】【原创内容，转载请注明出处】

HelloType.expect(10).to.match(Number)
let bool = HelloType.is(10).of(Number)

【关注微信公众号：wwwtangshua本文作者：唐霜，转载请注明出处。【原创不易，请尊重版权】ngnet】【本文受版权保护】【原创不易，请尊重版权】

expect.to.match

它提供对某个目标值进行校验的方法。Hel本文作者：唐霜，转载请注明出处。【关注微信公众号：wwwtangshuangnet】loType.expect.to.mat【未经授权禁止转载】本文作者：唐霜，转载请注明出处。ch是assert方法的别称，例如：

【原创不易，请尊重版权】【访问 www.tangshuang.n【作者：唐霜】【原创内容，转载请注明出处】et 获取更多精彩内容】

HelloType.expect(obj).to.match(SomeType)
// 等同于：
SomeType.assert(obj)

这两者是一样的。虽然前面一句的句子长很多【未经授权禁止转载】未经授权，禁止复制转载。，但是这主要是为了代码管理的方便。而且还【未经授权禁止转载】本文版权归作者所有，未经授权不得转载。有好处，先卖关子，后面会讲到。

catch.by

HelloType.catch.by是c原创内容，盗版必究。转载请注明出处：www.tangshuang.netatch方法的别称：

转载请注明出处：www.tangshua本文版权归作者所有，未经授权不得转载。【原创不易，请尊重版权】ng.net【原创不易，请尊重版权】【原创内容，转载请注明出处】未经授权，禁止复制转载。

var error = HelloType.catch(obj).by(SomeType)
// 等同于：
var error = SomeType.catch(obj)

track.by.with

HelloType.track.by.w本文版权归作者所有，未经授权不得转载。【关注微信公众号：wwwtangshuangnet】ith是track.with的别称：

var error = await HelloType.track(obj).by(SomeType).with(fn)
// 等同于：
var error = await SomeType.track(obj).with(fn)

trace.by.with

HelloType.trace.by.w【本文受版权保护】【关注微信公众号：wwwtangshuangnet】ith是trace.with的别称：

本文版权归作者所有，未经授权不得转载。【本文受版权保护】

var error = await HelloType.trace(obj).by(SomeType).with(fn)
// 等同于：
var error = await SomeType.trace(obj).with(fn)

is.typeof

HelloType.is.typeof是【未经授权禁止转载】著作权归作者所有，禁止商业用途转载。test的别称：

var bool = HelloType.is(SomeType).typeof(obj)
// 等同于：
var bool = SomeType.test(obj)

is.of

与is.typeof形成反转，即参数是颠【访问 www.tangshuang.net 获取更多精彩内容】【作者：唐霜】倒的。

著作权归作者所有，禁止商业用途转载。转载请注明出处：www.tangshua【本文受版权保护】未经授权，禁止复制转载。ng.net未经授权，禁止复制转载。原创内容，盗版必究。

let bool = HelloType.is(10).of(Number)

of后面跟规则。

decorate

ES7提供了装饰器的能力，用以对一个类及【原创不易，请尊重版权】【访问 www.tangshuang.net 获取更多精彩内容】其成员进行装饰。这部分内容，对于比较熟悉原创内容，盗版必究。【转载请注明来源】的开发者应该不陌生，如果你不熟悉，不使用原创内容，盗版必究。转载请注明出处：www.tangshuang.net也是没关系的。

【原创内容，转载请注明出处】著作权归作者所有，禁止商业用途转载。本文版权归作者所有，未经授权不得转载。

with

HelloType.decorate.w未经授权，禁止复制转载。转载请注明出处：www.tangshuang.netith可以直接装饰类，也可以装饰属性成员转载请注明出处：www.tangshuang.net转载请注明出处：www.tangshuang.net：

@HelloType.decorate.with(ParamsType)
class A {
  @HelloType.decorate.with(ObjectType)
  obj = {}
}

上面这段代码，会在new A的时候，对c【关注微信公众号：wwwtangshuangnet】【原创不易，请尊重版权】onstructor的参数进行校验。

input.with

【原创内容，转载请注明出处】【原创内容，转载请注明出处】

class A {
  @HelloType.decorate.with(FunctionType)
  @HelloType.decorate.input.with(ParamsType)
  say(msg) {}
}

output.with

class A {
  @HelloType.decorate.with(FunctionType)
  @HelloType.decorate.input.with(ParamsType)
  @HelloType.decorate.output.with(ReturnType)
  say(msg) {}
}

小结

【作者：唐霜】未经授权，禁止复制转载。

@HelloType.decorate.input.with((...args) => {
  ParamsType.assert(...args)
})

define

HelloType.define的功能是【关注微信公众号：wwwtangshuangnet】【访问 www.tangshuang.net 获取更多精彩内容】，将一个对象转化为规定的类型对应的对象，【未经授权禁止转载】【本文首发于唐霜的博客】在修改对象值的时候，会进行值的类型检查。未经授权，禁止复制转载。未经授权，禁止复制转载。例如：

【关注微信公众号：wwwtangshua【作者：唐霜】著作权归作者所有，禁止商业用途转载。ngnet】【未经授权禁止转载】【未经授权禁止转载】【本文首发于唐霜的博客】

const ObjType = Dict({
  name: String,
  age: Number,
  sub: {
    key: Object,
  },
})
let obj = HelloType.define({}).by(ObjType)

这需要注意，define不会修改原始值，【原创内容，转载请注明出处】【作者：唐霜】而是先克隆一个备份之后再赋值给obj。d【访问 www.tangshuang.net 获取更多精彩内容】【原创内容，转载请注明出处】efine的结果会自带规定的那些属性，例【原创不易，请尊重版权】转载请注明出处：www.tangshuang.net如obj.sub.key已经有了，虽然是【未经授权禁止转载】【版权所有，侵权必究】undefined，但是不会报错。

原创内容，盗版必究。【本文首发于唐霜的博客】本文版权归作者所有，未经授权不得转载。

经过define之后，如果你进行赋值ob【版权所有，侵权必究】【本文受版权保护】j.sub.key = 10就会报错，因本文版权归作者所有，未经授权不得转载。本文版权归作者所有，未经授权不得转载。为obj.sub.key必须是一个obj本文作者：唐霜，转载请注明出处。【版权所有】唐霜 www.tangshuang.netect。这个时候，你可能还会用上Lamb【版权所有】唐霜 www.tangshuang.net【版权所有】唐霜 www.tangshuang.netda，可以往上翻看它的具体方法。

其他方法

silent/Silent

安静模式，仅对HelloType.exp转载请注明出处：www.tangshuang.net原创内容，盗版必究。ect.to.match有效，直接使用容原创内容，盗版必究。【未经授权禁止转载】器不会生效。所谓安静模式，意思是不通过t原创内容，盗版必究。【本文受版权保护】hrow TypeError终止进程，但【访问 www.tangshuang.net 获取更多精彩内容】【本文首发于唐霜的博客】是抛出错误。

HelloType.silent = true
HelloType.expect(obj).to.match(SomeType) // 如果不匹配，不会报错中断进程，而是console.error打印错误，且不会阻断程序

从这点上讲，只有expect.to.ma本文版权归作者所有，未经授权不得转载。原创内容，盗版必究。tch、define里面的不通过情况下可本文版权归作者所有，未经授权不得转载。【未经授权禁止转载】以使用silent模式。因此，你在想使用【访问 www.tangshuang.net 获取更多精彩内容】【转载请注明来源】安静模式的时候，要选对方法。当安静模式开【版权所有，侵权必究】未经授权，禁止复制转载。启时，expect.to.match不会【本文受版权保护】【原创内容，转载请注明出处】阻断进程，因此，你也可以利用这点做些动作【转载请注明来源】转载请注明出处：www.tangshuang.net。

未经授权，禁止复制转载。本文作者：唐霜，转载请注明出处。【转载请注明来源】

Silent和silent是一模一样的，【转载请注明来源】【作者：唐霜】只是为了编程习惯，提供大小写区分而已。

注意：安静模式是全局的，一旦你设置了He【本文受版权保护】未经授权，禁止复制转载。lloType.silent为true，本文版权归作者所有，未经授权不得转载。【原创内容，转载请注明出处】其他任何你使用HelloType.exp转载请注明出处：www.tangshuang.net【转载请注明来源】ect.to.match的地方都会被改变【未经授权禁止转载】【本文首发于唐霜的博客】为安静模式，因此，你必须确定是不是要全局【访问 www.tangshuang.net 获取更多精彩内容】【未经授权禁止转载】开启安静模式。如果不是，建议你从正确的H【作者：唐霜】未经授权，禁止复制转载。elloType方法中挑选使用。

bind

当你使用辅助器的时候，有的时候，你想传入【原创内容，转载请注明出处】【本文受版权保护】一个函数，用来捕获任何可能出现的报错。这【本文受版权保护】【未经授权禁止转载】个时候，你可以使用bind来绑定一个函数未经授权，禁止复制转载。【访问 www.tangshuang.net 获取更多精彩内容】：

const fn = (error) => {
  saveToCacheStore(error)
}
HelloType.bind(fn)

当你在使用expect.to.match【转载请注明来源】本文版权归作者所有，未经授权不得转载。或者使用define的时候，运行过程中由著作权归作者所有，禁止商业用途转载。本文作者：唐霜，转载请注明出处。于数据和类型不匹配抛出错误时，但fn会运【转载请注明来源】【本文首发于唐霜的博客】行。这样，无论你是否在安静模式下，都可以未经授权，禁止复制转载。原创内容，盗版必究。获得错误信息，并把它记录在本地，以备之后【原创不易，请尊重版权】【原创不易，请尊重版权】做分析。

【作者：唐霜】本文作者：唐霜，转载请注明出处。【访问 www.tangshuang.n未经授权，禁止复制转载。转载请注明出处：www.tangshuang.netet 获取更多精彩内容】

另外，trace和track辅助器原本是【关注微信公众号：wwwtangshuangnet】本文版权归作者所有，未经授权不得转载。要传入一个fn到with中，用来抓取错误【关注微信公众号：wwwtangshuangnet】本文版权归作者所有，未经授权不得转载。，而如果你使用bind绑定了函数，就可以【未经授权禁止转载】未经授权，禁止复制转载。不用传with也可以收集到错误信息。

unbind

本文版权归作者所有，未经授权不得转载。【本文首发于唐霜的博客】本文作者：唐霜，转载请注明出处。原创内容，盗版必究。

Error

这是整个HelloType里面最隐性的一【原创内容，转载请注明出处】【本文受版权保护】个部分，开发者在默认情况下不会用到Hel【本文首发于唐霜的博客】【原创不易，请尊重版权】loType.Error，但是实际上，每【原创内容，转载请注明出处】【访问 www.tangshuang.net 获取更多精彩内容】次接收到HelloType默认抛出的错误【转载请注明来源】转载请注明出处：www.tangshuang.net时，错误的类型都是它。HelloType【版权所有，侵权必究】【关注微信公众号：wwwtangshuangnet】.Error是基于TypeError的错未经授权，禁止复制转载。【本文首发于唐霜的博客】误对象扩展，它具备非常高级的功能，因此，【访问 www.tangshuang.net 获取更多精彩内容】原创内容，盗版必究。在自定义一个Rule的时候，建议返回He转载请注明出处：www.tangshuang.net本文作者：唐霜，转载请注明出处。lloType.Error的实例，这样才【关注微信公众号：wwwtangshuangnet】著作权归作者所有，禁止商业用途转载。能发挥HelloType的最大功能。

本文作者：唐霜，转载请注明出处。著作权归作者所有，禁止商业用途转载。

引入和使用

想要使用HelloTypeError很简本文作者：唐霜，转载请注明出处。【原创不易，请尊重版权】单，通过包引入即可：

import HelloType from 'hello-type'

【转载请注明来源】本文作者：唐霜，转载请注明出处。未经授权，禁止复制转载。未经授权，禁止复制转载。

let err = new HelloType.Error(message)

秘密

HelloType.Error比任何Er【原创不易，请尊重版权】【版权所有】唐霜 www.tangshuang.netror类型都更加强化，它拥有更为复杂的结本文作者：唐霜，转载请注明出处。【原创内容，转载请注明出处】构，但仍然保持Error的基本结构。那么转载请注明出处：www.tangshuang.net本文版权归作者所有，未经授权不得转载。接下来，让我们来看看它都拥有哪些神秘的东【版权所有】唐霜 www.tangshuang.net【版权所有，侵权必究】东。

【本文首发于唐霜的博客】【原创内容，转载请注明出处】

traces

和普通Error不同，HelloType【未经授权禁止转载】本文版权归作者所有，未经授权不得转载。.Error是为HelloType服务的【关注微信公众号：wwwtangshuangnet】本文作者：唐霜，转载请注明出处。，在HelloType中，必须追踪到错误【原创不易，请尊重版权】【原创内容，转载请注明出处】发生的具体路径，因此，当一个错误产生时，转载请注明出处：www.tangshuang.net【关注微信公众号：wwwtangshuangnet】追踪信息就至关重要。而这些追踪信息，不仅未经授权，禁止复制转载。原创内容，盗版必究。能得到错误发生时的基本信息，而且具体是什【版权所有，侵权必究】本文作者：唐霜，转载请注明出处。么值发生了错误，都可以通过检查error【转载请注明来源】本文作者：唐霜，转载请注明出处。.traces得到。有兴趣的你，可以打印本文版权归作者所有，未经授权不得转载。【版权所有，侵权必究】出来看看。

著作权归作者所有，禁止商业用途转载。著作权归作者所有，禁止商业用途转载。

let error = HelloType.catch(some).by(SomeType)
if (error) {
  console.log(error.traces)
}

addtrace(traceinfo)

但是，如果一个普通用户，想要独立使用He【本文受版权保护】本文版权归作者所有，未经授权不得转载。lloType.Error时，就可以使用本文版权归作者所有，未经授权不得转载。【未经授权禁止转载】error.addtrace来在trac著作权归作者所有，禁止商业用途转载。转载请注明出处：www.tangshuang.netes链中添加一个追踪记录，添加使用的是u【作者：唐霜】【原创内容，转载请注明出处】nshift，因此新增的记录被加在整个链【本文首发于唐霜的博客】【本文首发于唐霜的博客】条的最前面。这是由于我们在使用trace【关注微信公众号：wwwtangshuangnet】【版权所有，侵权必究】s的时候，其实它是一个自下而上冒泡的过程原创内容，盗版必究。【转载请注明来源】。总之，最后，traces这个数组记录了著作权归作者所有，禁止商业用途转载。【版权所有】唐霜 www.tangshuang.net从错误发生的位置，到最外层的追踪，以此可【未经授权禁止转载】未经授权，禁止复制转载。以知道到底是型式的哪个位置发生了问题。

addtrace的参数是任意的对象，它只【未经授权禁止转载】本文版权归作者所有，未经授权不得转载。是用来作为记录的，如果是脱离HelloT著作权归作者所有，禁止商业用途转载。【作者：唐霜】ype独立使用，开发者可以自己规定一种对转载请注明出处：www.tangshuang.net【访问 www.tangshuang.net 获取更多精彩内容】象模式。

error.addtrace({
  key: 'name',
  value: 'tomy',
})

message

而message和普通的Error不同，著作权归作者所有，禁止商业用途转载。本文作者：唐霜，转载请注明出处。普通的Error传入的message就是【作者：唐霜】本文作者：唐霜，转载请注明出处。最后Error抛出的错误信息。但是Hel【原创内容，转载请注明出处】【访问 www.tangshuang.net 获取更多精彩内容】loType.Error的message原创内容，盗版必究。【转载请注明来源】高级很多，它支持{插值}。

let error = new HelloType.Error('{name} is wrong.', {
  name: 'tomy',
})

而最终message内容展示出什么内容，本文版权归作者所有，未经授权不得转载。未经授权，禁止复制转载。summary才是message的值的来【本文首发于唐霜的博客】本文版权归作者所有，未经授权不得转载。源。这就非常好玩了，有了这样的功能，那么未经授权，禁止复制转载。【作者：唐霜】message的内容就可以根据trace【作者：唐霜】【转载请注明来源】信息发生变化。因此，在创建一个error本文版权归作者所有，未经授权不得转载。未经授权，禁止复制转载。的时候，最好是可以提前通过插值来安排你的原创内容，盗版必究。【访问 www.tangshuang.net 获取更多精彩内容】消息。

let error = new HelloType.Error('{stack} at {line}:{column}')

error.addtrace({
  stack: 'type error',
  line: 10,
  column: 20,
})

console.log(error.message)

summary

而将所有的traces整理之后，就是su著作权归作者所有，禁止商业用途转载。【转载请注明来源】mmary。你可以通过直接读取error著作权归作者所有，禁止商业用途转载。【版权所有】唐霜 www.tangshuang.net.summary来得到摘要信息，这些信息【版权所有】唐霜 www.tangshuang.net【版权所有，侵权必究】将被用作构建message的材料，你可以【原创内容，转载请注明出处】【转载请注明来源】直接在message中使用它们。它有几个未经授权，禁止复制转载。【本文受版权保护】非常有用的属性：keyPath、shou原创内容，盗版必究。【原创不易，请尊重版权】ld、receive。

著作权归作者所有，禁止商业用途转载。未经授权，禁止复制转载。【未经授权禁止转载】【转载请注明来源】

keyPath 用来获取相对于被验证对象转载请注明出处：www.tangshuang.net著作权归作者所有，禁止商业用途转载。，发生错误的位置。

【原创内容，转载请注明出处】

转载请注明出处：www.tangshua本文作者：唐霜，转载请注明出处。未经授权，禁止复制转载。ng.net

【原创内容，转载请注明出处】

should 表示这个位置应该是一个什么【访问 www.tangshuang.net 获取更多精彩内容】本文版权归作者所有，未经授权不得转载。类型的数据（摘要）。

【未经授权禁止转载】

【原创不易，请尊重版权】

receive 表示这个位置实际接收到的【原创不易，请尊重版权】【转载请注明来源】数据（摘要值，字符串表示）

著作权归作者所有，禁止商业用途转载。

【作者：唐霜】

【原创内容，转载请注明出处】

stack 堆栈信息。

未经授权，禁止复制转载。

【关注微信公众号：wwwtangshua【访问 www.tangshuang.net 获取更多精彩内容】【本文受版权保护】ngnet】

【本文首发于唐霜的博客】

原创内容，盗版必究。

research 获取用以分析对应的ke【版权所有】唐霜 www.tangshuang.net【本文受版权保护】yPath上更为完整的规则信息，这些信息【原创内容，转载请注明出处】本文版权归作者所有，未经授权不得转载。虽然都可以从traces中提炼出来，但是【关注微信公众号：wwwtangshuangnet】【转载请注明来源】你可以在message中使用{resea转载请注明出处：www.tangshuang.net本文版权归作者所有，未经授权不得转载。rch}就打印这些信息

【本文首发于唐霜的博客】

著作权归作者所有，禁止商业用途转载。

console.log(error.summary.stack)

因为对于输出的message而言，由于考【本文受版权保护】未经授权，禁止复制转载。虑到输出结果的长度和一些敏感性问题，sh【未经授权禁止转载】【本文首发于唐霜的博客】ould和receive输出的都是摘要信著作权归作者所有，禁止商业用途转载。【版权所有，侵权必究】息，它会对原始信息进行简单处理，例如截取转载请注明出处：www.tangshuang.net【访问 www.tangshuang.net 获取更多精彩内容】字符串、省略object的属性值、只显示【本文受版权保护】【版权所有，侵权必究】数组的长度等。

本文版权归作者所有，未经授权不得转载。【关注微信公众号：wwwtangshua【原创不易，请尊重版权】【本文首发于唐霜的博客】ngnet】【转载请注明来源】

rule 所在位置的规则

【本文首发于唐霜的博客】

【未经授权禁止转载】

【原创不易，请尊重版权】

type 所在位置的类型

【关注微信公众号：wwwtangshua【作者：唐霜】【关注微信公众号：wwwtangshuangnet】ngnet】

【作者：唐霜】

原创内容，盗版必究。

value 所在位置的真实值

原创内容，盗版必究。

转载请注明出处：www.tangshua本文版权归作者所有，未经授权不得转载。【访问 www.tangshuang.net 获取更多精彩内容】ng.net

本文作者：唐霜，转载请注明出处。

translate(message, replace)

不过，一般情况下，HelloType抛出原创内容，盗版必究。转载请注明出处：www.tangshuang.net的错误，都是提前预设好了message的未经授权，禁止复制转载。【访问 www.tangshuang.net 获取更多精彩内容】。下文会讲怎么修改默认的message，【本文受版权保护】本文作者：唐霜，转载请注明出处。但是，如果你在得到一个error的时候，本文作者：唐霜，转载请注明出处。【本文首发于唐霜的博客】又不想用它默认的message，想在特殊【原创内容，转载请注明出处】【未经授权禁止转载】情况下，提供特殊的message信息。这【版权所有】唐霜 www.tangshuang.net未经授权，禁止复制转载。个时候，可以使用error的transl【版权所有】唐霜 www.tangshuang.net本文版权归作者所有，未经授权不得转载。ate方法：

let msg = error.translate('{keyPath}不在{receive}中。')
console.log(msg)

这样，你就可以利用error的summa未经授权，禁止复制转载。【作者：唐霜】ry来得到一个新的message信息，在【未经授权禁止转载】原创内容，盗版必究。特殊情况下，返回特殊文本体现。具体的案例【本文首发于唐霜的博客】原创内容，盗版必究。，你可以看下我github上exampl【关注微信公众号：wwwtangshuangnet】【转载请注明来源】es目录下的例子。

【作者：唐霜】【转载请注明来源】【原创不易，请尊重版权】

它的第二个参数是一个Boolean变量，【版权所有，侵权必究】【未经授权禁止转载】当设置为true时，表示经过transl【版权所有，侵权必究】本文版权归作者所有，未经授权不得转载。ate之后，替换掉原始的error.me本文版权归作者所有，未经授权不得转载。本文作者：唐霜，转载请注明出处。ssage，下一次你再读取error.m【本文受版权保护】转载请注明出处：www.tangshuang.netessage将会是经过translate【本文首发于唐霜的博客】【未经授权禁止转载】之后的内容。

著作权归作者所有，禁止商业用途转载。【本文受版权保护】

error.translate('{keyPath}不在{receive}中。', true)
console.log(error.message)

messages

修改HelloType内置的错误提示语。未经授权，禁止复制转载。未经授权，禁止复制转载。HelloType的所有错误提示语位于e【本文受版权保护】著作权归作者所有，禁止商业用途转载。rror.js里面，你可以阅读源码，查阅【原创内容，转载请注明出处】【关注微信公众号：wwwtangshuangnet】所有可以修改的提示语信息。通过messa【转载请注明来源】本文作者：唐霜，转载请注明出处。ges方法，传入一个对象，用来覆盖默认提【版权所有，侵权必究】未经授权，禁止复制转载。示语。提示语里面支持{插值}，但是每个提【关注微信公众号：wwwtangshuangnet】著作权归作者所有，禁止商业用途转载。示语的插值是固定的，请查看源码了解。例如【原创内容，转载请注明出处】【版权所有】唐霜 www.tangshuang.net你可以这样：

【作者：唐霜】未经授权，禁止复制转载。著作权归作者所有，禁止商业用途转载。转载请注明出处：www.tangshua【作者：唐霜】【关注微信公众号：wwwtangshuangnet】ng.net

HelloType.Error.messages.refuse = '{keyPath}不符合类型{should}，接收到的是{receive}。'

【转载请注明来源】未经授权，禁止复制转载。【本文首发于唐霜的博客】

refuse 一般类型校验不符，支持ke【访问 www.tangshuang.net 获取更多精彩内容】【本文首发于唐霜的博客】yPath, research, sta本文版权归作者所有，未经授权不得转载。未经授权，禁止复制转载。ck, should, receive

【本文受版权保护】

【原创内容，转载请注明出处】

【转载请注明来源】

dirty 长度不符合，例如参数长度不符著作权归作者所有，禁止商业用途转载。【版权所有】唐霜 www.tangshuang.net合，数组（严格模式）长度不符合，对象（严原创内容，盗版必究。【关注微信公众号：wwwtangshuangnet】格模式）属性数量不符合，支持keyPat转载请注明出处：www.tangshuang.net本文版权归作者所有，未经授权不得转载。h, research, stack, 【访问 www.tangshuang.net 获取更多精彩内容】转载请注明出处：www.tangshuang.netlength。length表示应该接收的【未经授权禁止转载】【转载请注明来源】长度。

【关注微信公众号：wwwtangshua【转载请注明来源】著作权归作者所有，禁止商业用途转载。ngnet】

【关注微信公众号：wwwtangshua【本文受版权保护】【访问 www.tangshuang.net 获取更多精彩内容】ngnet】

未经授权，禁止复制转载。

【访问 www.tangshuang.n【转载请注明来源】转载请注明出处：www.tangshuang.netet 获取更多精彩内容】

overflow 属性溢出，主要是严格模原创内容，盗版必究。【版权所有，侵权必究】式下出现了多余的对象属性，支持keyPa本文版权归作者所有，未经授权不得转载。【原创不易，请尊重版权】th, research, stack,转载请注明出处：www.tangshuang.net【原创内容，转载请注明出处】 keys。keys表示支持的属性名，不【原创不易，请尊重版权】【版权所有】唐霜 www.tangshuang.net在这些keys中间的key表示是溢出的。

【未经授权禁止转载】

【转载请注明来源】

原创内容，盗版必究。

【原创内容，转载请注明出处】

原创内容，盗版必究。

结束语

以上就是有关HelloType的所有使用转载请注明出处：www.tangshuang.net转载请注明出处：www.tangshuang.net方法，当然，有一些隐性的东西我不会透露出【版权所有】唐霜 www.tangshuang.net【未经授权禁止转载】来，因为有些方法并不常用，或者不应该用，【访问 www.tangshuang.net 获取更多精彩内容】【本文首发于唐霜的博客】有兴趣的读者可以自己去阅读源码是怎么实现原创内容，盗版必究。【作者：唐霜】的。

未经授权，禁止复制转载。原创内容，盗版必究。

未经授权，禁止复制转载。【本文首发于唐霜的博客】本文作者：唐霜，转载请注明出处。【关注微信公众号：wwwtangshua原创内容，盗版必究。转载请注明出处：www.tangshuang.netngnet】

我在自己的博客中提到过，开源的真正意义，转载请注明出处：www.tangshuang.net未经授权，禁止复制转载。不是在于提供一款免费的产品，而是在于提供著作权归作者所有，禁止商业用途转载。转载请注明出处：www.tangshuang.net一种问题的解决思路，给其他人去参考。都说著作权归作者所有，禁止商业用途转载。原创内容，盗版必究。开发中不要重复造轮子，但是由于开源协议，本文作者：唐霜，转载请注明出处。未经授权，禁止复制转载。或者具体某个需求的不确定性，改造轮子是很【原创内容，转载请注明出处】【转载请注明来源】正常的事，我觉得“不要重复造轮子”是说，著作权归作者所有，禁止商业用途转载。【原创不易，请尊重版权】不应该为了解决前人已经解决过的问题，从零【作者：唐霜】【关注微信公众号：wwwtangshuangnet】开始思考，构建一套自己的实现，而应该站在【版权所有，侵权必究】原创内容，盗版必究。巨人肩膀上，直接把前人解决问题的思维方式【关注微信公众号：wwwtangshuangnet】【关注微信公众号：wwwtangshuangnet】甚至思路借鉴过来，在此基础上，再去实现具【访问 www.tangshuang.net 获取更多精彩内容】【访问 www.tangshuang.net 获取更多精彩内容】体需求。一味的拒绝使用别人的代码（思路）本文版权归作者所有，未经授权不得转载。【原创不易，请尊重版权】或一味的否定拒绝使用别人的代码我认为都是【本文受版权保护】著作权归作者所有，禁止商业用途转载。不合理的。最近红芯浏览器内核的事闹的沸沸【原创不易，请尊重版权】【原创内容，转载请注明出处】扬扬，我觉得可能是整个业界的一种自卑心态未经授权，禁止复制转载。本文版权归作者所有，未经授权不得转载。。实际上，任何一项技术，都是站在前人的肩【版权所有】唐霜 www.tangshuang.net【版权所有】唐霜 www.tangshuang.net膀上获得成功，chrome内核也用了很多【转载请注明来源】【本文受版权保护】别人的东西，做一款基于Chrome内核的本文版权归作者所有，未经授权不得转载。【本文首发于唐霜的博客】浏览器是没有什么错的，只不过在推广的时候【原创不易，请尊重版权】未经授权，禁止复制转载。，打上一些“首款自主研发”这样的词汇，不著作权归作者所有，禁止商业用途转载。【原创不易，请尊重版权】免让人觉得是在骗国家的钱。好了，这种吐槽本文作者：唐霜，转载请注明出处。转载请注明出处：www.tangshuang.net也没有太大意义，只希望读者能够从Hell本文作者：唐霜，转载请注明出处。【转载请注明来源】oType项目中得到一点启发，根据自己的【本文受版权保护】原创内容，盗版必究。需要获取需要的部分。

原创内容，盗版必究。本文作者：唐霜，转载请注明出处。【转载请注明来源】

【本文首发于唐霜的博客】【作者：唐霜】著作权归作者所有，禁止商业用途转载。【版权所有】唐霜 www.tangshuang.net转载请注明出处：www.tangshuang.net【未经授权禁止转载】【关注微信公众号：wwwtangshuangnet】原创内容，盗版必究。著作权归作者所有，禁止商业用途转载。著作权归作者所有，禁止商业用途转载。本文版权归作者所有，未经授权不得转载。【本文首发于唐霜的博客】本文作者：唐霜，转载请注明出处。【本文受版权保护】著作权归作者所有，禁止商业用途转载。【访问 www.tangshuang.net 获取更多精彩内容】【转载请注明来源】本文作者：唐霜，转载请注明出处。【原创不易，请尊重版权】本文作者：唐霜，转载请注明出处。本文作者：唐霜，转载请注明出处。【版权所有，侵权必究】【版权所有，侵权必究】本文作者：唐霜，转载请注明出处。本文版权归作者所有，未经授权不得转载。本文版权归作者所有，未经授权不得转载。转载请注明出处：www.tangshuang.net著作权归作者所有，禁止商业用途转载。转载请注明出处：www.tangshuang.net【版权所有】唐霜 www.tangshuang.net【原创不易，请尊重版权】

如果你觉得本书对你有帮助，通过下方的二维码向我打赏吧，帮助我写出更多有用的内容。

2018-08-26 | HelloType, 数据类型, 类型检查

已有20条评论

sunflower 2019-03-08 20:37

目前有个问题就是，后端正常返回对象，降级返回[]，就会有问题

回复
sunflower 2019-03-08 20:26

如果是多种类型校验，既可以是对象，也可以是数组

回复
- 否子戈 2019-03-08 22:50
  
  灵活运用各个方法，才能得到你想要到结果，例如使用Enum，IfNotMatch等，总之，HelloType是一个非常灵活的系统，你需要在实际使用的时候根据自己的情况选择不同的方式来创建规则。
  
  回复
  - sunflower 2019-03-10 14:47
    
    const DistType = Dict({
        name: String,
        age: Number
      })
      const SomeType = {
        ret: Number,
        data: IfNotMatch(DistType, [])
      }
      const some = {
        ret: 1,
        data: []
      }
    
      HelloType.expect(some).to.match(SomeType)
    Enum不太适合，IfNotMatch没有实现，如果传入空数组，不报错，感觉实现不了我的需求
    
    回复
    - 否子戈 2019-03-10 22:01
      
      你具体要实现什么目的？
      
      回复
      - sunflower 2019-03-11 10:08
        
        可以是两种数据结构，对象或者数组，DIct || LIst ，能实现吗
      - 否子戈 2019-03-11 10:11
        
        Enum(Dict, List)
qte 2019-01-04 17:01

用了一下今天，我发现必须显式声明HelloType.Slient = true;
不然我的chrome console里没有任何内容（另外slient拼错了）。
另外使用上，把trace放在快速入门demo更明显的位置会比较好吧，match的返回值也应该强调下（个人建议）。

回复
- 否子戈 2019-01-04 22:19
  
  感谢指出单词拼写错误！！！
  不过你指出的无法打印错误的情况我没遇到，可否将你的用法贴出来看下
  
  回复
sunflower 2019-01-01 16:29

打印错误的时候能打印后端传递的整个对象吗

回复
- 否子戈 2019-01-01 16:36
  
  为了避免敏感数据问题，输出的错误提示中去掉了一些东西，不过你可以在检验的时候自己获取error，然后读取error.summary来得到更丰富的信息。
  另外，你的具体使用场景是怎样？可以把代码贴出来，我看看有没有什么更好的办法。
  
  回复
  - sunflower 2019-01-02 10:26
    
    helloType.expect(resData).to.match(shopqueryType) 能error能打印整个后端对象resData详情信息吗？目前好像只能自己记录了，是吗
    
    回复
    - 否子戈 2019-01-02 10:29
      
      所有的error都有一个summary属性，可以打出来看，注意看文档
      
      回复
    - 否子戈 2019-01-02 10:31
      
      另外，你后端都整个response是你都入参啊，不需要再到HelloType里面去打印，直接打印出来就可以了
      
      回复
      - sunflower 2019-01-02 10:34
        
        我现在就是要在错误的时候记录，后端返回的整个对象，方便记录，error. summary好像并不能满足
      - 否子戈 2019-01-02 11:15
        
        HelloType.track(resData).by(shopqueryType).with(error => {
        console.error(error.translate(‘后台返回数据 {keyPath} 应该是 {should} ，后台返回数据为：’), resData)
        })
        
        方法有很多，看你怎么去用error的用法参考 https://www.tangshuang.net/5625.html#title-9-2
玲玲 2018-12-27 18:09

如果发现类型不对，能实现自动转化吗

回复
- 否子戈 2018-12-27 18:11
  
  可以用IfNotMatch试试
  
  回复
  - 玲玲 2018-12-27 20:25
    
    IfNotMatch(String) 第二个参数是默认值转了
    
    回复
    - 否子戈 2018-12-27 23:29
      
      没明白你意思
      
      回复