返回：唐霜｜书

HelloType使用手册

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

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

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

本项目不再维护，基于项目理念，我开发的转载请注明出处：www.tangshuang.net【版权所有】唐霜 www.tangshuang.nettyshemo 更合理。请使用 tyshemo转载请注明出处：www.tangshuang.net。未经授权，禁止复制转载。
【访问 www.tangshuang.net 获取更多精彩内容】【转载请注明来源】【转载请注明来源】原创内容，盗版必究。

著作权归作者所有，禁止商业用途转载。【原创不易，请尊重版权】未经授权，禁止复制转载。转载请注明出处：www.tangshuang.net转载请注明出处：www.tangshuang.net

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

原创内容，盗版必究。【访问 www.tangshuang.net 获取更多精彩内容】【本文受版权保护】

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

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

我实在不能忍受这种情况的继续发生，所以，【原创不易，请尊重版权】本文作者：唐霜，转载请注明出处。我写了HelloType，一方面是解决这未经授权，禁止复制转载。【版权所有，侵权必究】一现实问题，另一方面也算是自己在js弱数【版权所有】唐霜 www.tangshuang.net【作者：唐霜】据类型下的探索。因此，我希望写一个手册，【本文受版权保护】本文版权归作者所有，未经授权不得转载。不仅把怎么使用HelloType说清楚，【关注微信公众号：wwwtangshuangnet】原创内容，盗版必究。也希望能把自己在这个过程中的一些思想讲清【关注微信公众号：wwwtangshuangnet】转载请注明出处：www.tangshuang.net楚，这也可以为其他开发者提供一些思维上的【原创不易，请尊重版权】【作者：唐霜】借鉴。

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

转载请注明出处：www.tangshuang.net未经授权，禁止复制转载。【关注微信公众号：wwwtangshuangnet】

HelloType中的“类型”和编程语言【未经授权禁止转载】【原创不易，请尊重版权】里面的“类型”是有区别的，在HelloT【访问 www.tangshuang.net 获取更多精彩内容】【未经授权禁止转载】ype里面的“类型”更多的是指一个容器，【本文首发于唐霜的博客】【本文受版权保护】本质也就是一个js对象实例，这个实例拥有【原创不易，请尊重版权】转载请注明出处：www.tangshuang.net一些方法，利用这些方法，就可以判断一个变【作者：唐霜】著作权归作者所有，禁止商业用途转载。量所存储的数据是不是符合这个类型的要求。

本文作者：唐霜，转载请注明出处。【访问 www.tangshuang.net 获取更多精彩内容】【本文受版权保护】

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

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

原型 prototype原创内容，盗版必究。

著作权归作者所有，禁止商业用途转载。【访问 www.tangshuang.net 获取更多精彩内容】【关注微信公众号：wwwtangshuangnet】本文版权归作者所有，未经授权不得转载。未经授权，禁止复制转载。

著作权归作者所有，禁止商业用途转载。【关注微信公众号：wwwtangshuangnet】【作者：唐霜】转载请注明出处：www.tangshuang.net【本文受版权保护】

Number 数值，不包含NaN和Fin转载请注明出处：www.tangshuang.net转载请注明出处：www.tangshuang.netite

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

【本文受版权保护】

String 字符串【版权所有，侵权必究】

【本文受版权保护】

原创内容，盗版必究。

【作者：唐霜】

【未经授权禁止转载】

Boolean 逻辑值，只包含true和【版权所有】唐霜 www.tangshuang.net本文版权归作者所有，未经授权不得转载。false

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

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

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

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

原创内容，盗版必究。

转载请注明出处：www.tangshuang.net

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

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

Object 对象，不包含其他对obje【原创不易，请尊重版权】【版权所有，侵权必究】ct进行扩展后的对象

【关注微信公众号：wwwtangshuangnet】

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

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

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

RegExp 正则表达式本文作者：唐霜，转载请注明出处。

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

【关注微信公众号：wwwtangshuangnet】

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

【本文受版权保护】

Symbol 标识符【版权所有】唐霜 www.tangshuang.net

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

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

转载请注明出处：www.tangshuang.net

原创内容，盗版必究。

Null【本文受版权保护】仅包含null【版权所有，侵权必究】

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

【本文受版权保护】

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

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

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

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

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

【关注微信公众号：wwwtangshuangnet】

NaN 仅包含NaN【版权所有】唐霜 www.tangshuang.net

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

【本文受版权保护】

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

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

Infinity 仅包含Infinity

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

转载请注明出处：www.tangshuang.net

原创内容，盗版必究。

Date 日期转载请注明出处：www.tangshuang.net

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

【转载请注明来源】

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

【访问 www.tangshuang.net 获取更多精彩内容】

Any著作权归作者所有，禁止商业用途转载。可为任意值的原型转载请注明出处：www.tangshuang.net

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

原创内容，盗版必究。

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

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

【关注微信公众号：wwwtangshuangnet】【原创不易，请尊重版权】【原创不易，请尊重版权】

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

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

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

本文作者：唐霜，转载请注明出处。【本文受版权保护】【原创内容，转载请注明出处】

const NumberType = new Type(Number)

这样，就用原型Number构造了一个容器【本文受版权保护】【访问 www.tangshuang.net 获取更多精彩内容】NumberType，接下来就可以用这个著作权归作者所有，禁止商业用途转载。转载请注明出处：www.tangshuang.net容器对某个具体的值进行断言：

【本文受版权保护】【关注微信公众号：wwwtangshuangnet】【关注微信公众号：wwwtangshuangnet】转载请注明出处：www.tangshuang.net

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

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

【作者：唐霜】【转载请注明来源】【未经授权禁止转载】

转载请注明出处：www.tangshuang.net【未经授权禁止转载】原创内容，盗版必究。

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

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

上面红色部分不是原型，但为什么可以传给T【版权所有】唐霜 www.tangshuang.net未经授权，禁止复制转载。ype构造器呢？因为它被我称为型式（pa原创内容，盗版必究。【关注微信公众号：wwwtangshuangnet】ttern），它是形式化的数据结构，这个【本文受版权保护】【版权所有，侵权必究】结构将对数据进行约束。也就是说，如果你用【版权所有】唐霜 www.tangshuang.net【本文受版权保护】SomeType去校验一个对象，那么对象【转载请注明来源】【转载请注明来源】必须有name、books两个属性，而且本文版权归作者所有，未经授权不得转载。【原创不易，请尊重版权】books属性值必须是数组。实际上，任何未经授权，禁止复制转载。未经授权，禁止复制转载。被传入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【转载请注明来源】著作权归作者所有，禁止商业用途转载。ned，Null这三个扩展的原型

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

【本文受版权保护】

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

基于Rule的内置规则：IfExists【原创不易，请尊重版权】本文作者：唐霜，转载请注明出处。, InstanceOf, Equal等【原创不易，请尊重版权】【版权所有，侵权必究】（下文介绍）

转载请注明出处：www.tangshuang.net

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

原创内容，盗版必究。

【作者：唐霜】

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

Type的实例：如new Type(Nu【版权所有，侵权必究】未经授权，禁止复制转载。mber)

原创内容，盗版必究。

转载请注明出处：www.tangshuang.net

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

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

【作者：唐霜】

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

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

【未经授权禁止转载】

HelloType内置了几种基于Rule原创内容，盗版必究。原创内容，盗版必究。的规则：

IfExists(rule) 如果该值存【关注微信公众号：wwwtangshuangnet】本文版权归作者所有，未经授权不得转载。在，就进行必须符合传入的规则

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

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

InstanceOf(prototype【转载请注明来源】【关注微信公众号：wwwtangshuangnet】) 该值是否是某个传入的JS原型的实例

【转载请注明来源】

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

原创内容，盗版必究。

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

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

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

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

转载请注明出处：www.tangshuang.net

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

IfNotMatch(rule, def【原创内容，转载请注明出处】原创内容，盗版必究。aultValue) 如果值不符合传入的【转载请注明来源】【作者：唐霜】规则，那么使用defaultValue替【原创内容，转载请注明出处】【本文受版权保护】换，仅对对象的属性值有效

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

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

转载请注明出处：www.tangshuang.net

【关注微信公众号：wwwtangshuangnet】

Lambda(paramsType, r原创内容，盗版必究。【未经授权禁止转载】eturnType) 值必须是一个函数，【原创不易，请尊重版权】著作权归作者所有，禁止商业用途转载。而且函数的参数、返回值必须符合要求，仅对【版权所有，侵权必究】【原创不易，请尊重版权】对象的属性值有效

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

原创内容，盗版必究。

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

比如，我们可以这样使用某个内置规则：【原创内容，转载请注明出处】

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

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

我们可以利用HelloType提供的构造著作权归作者所有，禁止商业用途转载。【关注微信公众号：wwwtangshuangnet】器创建自己的规则：

原创内容，盗版必究。【未经授权禁止转载】【访问 www.tangshuang.net 获取更多精彩内容】原创内容，盗版必究。

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【作者：唐霜】转载请注明出处：www.tangshuang.net这样使用SomeRule了，Null，U【访问 www.tangshuang.net 获取更多精彩内容】著作权归作者所有，禁止商业用途转载。ndefined，Any这三个扩展原型都【原创不易，请尊重版权】转载请注明出处：www.tangshuang.net是这样出来的。

转载请注明出处：www.tangshuang.net【作者：唐霜】著作权归作者所有，禁止商业用途转载。著作权归作者所有，禁止商业用途转载。【原创不易，请尊重版权】

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

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

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

原创内容，盗版必究。【原创内容，转载请注明出处】转载请注明出处：www.tangshuang.net【未经授权禁止转载】

快速入门未经授权，禁止复制转载。

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

这一章基于对一个api返回数据的类型检查【作者：唐霜】著作权归作者所有，禁止商业用途转载。的场景，教你快速上手HelloType。

包的安装和使用【作者：唐霜】

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

HelloType是一个npm包，你需要本文版权归作者所有，未经授权不得转载。【本文首发于唐霜的博客】通过npm进行安装：

未经授权，禁止复制转载。【转载请注明来源】未经授权，禁止复制转载。

npm install --save hello-type

接下来在你的项目中使用这个包，它支持ES转载请注明出处：www.tangshuang.net【转载请注明来源】6、AMD的模块引入，也支持直接联入到H【转载请注明来源】【关注微信公众号：wwwtangshuangnet】TML文档中使用。

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

// 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
})

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

创建类型检查容器【版权所有】唐霜 www.tangshuang.net

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

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数据进行检查【版权所有】唐霜 www.tangshuang.net

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

当我们通过ajax到服务器api接口拿到【访问 www.tangshuang.net 获取更多精彩内容】【版权所有】唐霜 www.tangshuang.net数据之后，并不能确保数据接口返回的结果一本文版权归作者所有，未经授权不得转载。转载请注明出处：www.tangshuang.net定是符合预期的，我们得在使用接口数据之前【关注微信公众号：wwwtangshuangnet】【作者：唐霜】进行类型和结构断言：

【转载请注明来源】转载请注明出处：www.tangshuang.net【原创内容，转载请注明出处】原创内容，盗版必究。

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函数，因此，当断言【作者：唐霜】转载请注明出处：www.tangshuang.net中报错时，会阻止程序继续往下执行，并抛出未经授权，禁止复制转载。【访问 www.tangshuang.net 获取更多精彩内容】错误，在使用函数时，可以通过catch获原创内容，盗版必究。转载请注明出处：www.tangshuang.net取到抛出的错误内容，并对错误内容进行解读【转载请注明来源】【访问 www.tangshuang.net 获取更多精彩内容】（例如上传到监控系统）。

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

看上去是不是很简单？看不懂？没关系，关于【原创内容，转载请注明出处】未经授权，禁止复制转载。Dict、List，以及Type里面套用本文作者：唐霜，转载请注明出处。【作者：唐霜】等，会在后文一一详解，只要继续阅读就能理【作者：唐霜】【原创内容，转载请注明出处】解了。

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

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

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

利用Type可以创建一个容器，它是一个构著作权归作者所有，禁止商业用途转载。本文作者：唐霜，转载请注明出处。造器，也是一个ES6的class，因此在【访问 www.tangshuang.net 获取更多精彩内容】【版权所有】唐霜 www.tangshuang.net使用时要用new去实例化。它没有任何配置【版权所有】唐霜 www.tangshuang.net【本文首发于唐霜的博客】项，每一个传入的值，都是一个型式，型式可本文作者：唐霜，转载请注明出处。【本文首发于唐霜的博客】以是任意内容，它会按照一定的规则进行型式【原创不易，请尊重版权】【版权所有，侵权必究】的格式化，形成规则体现。

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

constructor转载请注明出处：www.tangshuang.net

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

要使用Type，只能通过new关键字去实本文作者：唐霜，转载请注明出处。【转载请注明来源】例化一个实例出来，得到的就是一个类型容器本文作者：唐霜，转载请注明出处。【未经授权禁止转载】。

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

const NumberType = new Type(Number)

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

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

Number 仅仅匹配真实的数据，如果是【版权所有】唐霜 www.tangshuang.net【本文受版权保护】NaN或Infinite，都不能通过

转载请注明出处：www.tangshuang.net

原创内容，盗版必究。

【本文受版权保护】

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

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

String 仅仅匹配字符串，str =著作权归作者所有，禁止商业用途转载。【作者：唐霜】 new String中的str是一个对【版权所有】唐霜 www.tangshuang.net【关注微信公众号：wwwtangshuangnet】象，不能通过

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

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

原创内容，盗版必究。

【本文受版权保护】

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

Boolean 仅仅匹配true和fal著作权归作者所有，禁止商业用途转载。本文作者：唐霜，转载请注明出处。se这两个值，其他任何值都不通过

原创内容，盗版必究。

【本文受版权保护】

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

【作者：唐霜】

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

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

原创内容，盗版必究。

上面这四种类型都做了强制规定，因此，你在【本文首发于唐霜的博客】【转载请注明来源】用它们的时候，真的就跟它们的字面意思一样本文作者：唐霜，转载请注明出处。【关注微信公众号：wwwtangshuangnet】，不会产生副作用。在HelloType的【原创内容，转载请注明出处】【原创不易，请尊重版权】体系里，所有的原型在上一章已经说过了，这【作者：唐霜】【访问 www.tangshuang.net 获取更多精彩内容】里就不再赘述。

【本文受版权保护】转载请注明出处：www.tangshuang.net本文作者：唐霜，转载请注明出处。【作者：唐霜】

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

本文版权归作者所有，未经授权不得转载。转载请注明出处：www.tangshuang.net【未经授权禁止转载】

new Type支持同时传入一组型式，这原创内容，盗版必究。著作权归作者所有，禁止商业用途转载。样可以一次性对多个数据进行校验。这对于有【转载请注明来源】【转载请注明来源】多个参数的函数的参数校验非常有用：

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

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

传入new Type的型式是你最直观的一【未经授权禁止转载】【访问 www.tangshuang.net 获取更多精彩内容】种书写方式，比如一个对象结构，或者一个数转载请注明出处：www.tangshuang.net转载请注明出处：www.tangshuang.net组结构：

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

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

assert【访问 www.tangshuang.net 获取更多精彩内容】

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

assert方法是Type容器的最重要方原创内容，盗版必究。【版权所有】唐霜 www.tangshuang.net法，也是所有HelloType方法的基础转载请注明出处：www.tangshuang.net【原创不易，请尊重版权】。当你完成Type实例化，创建了一个容器【作者：唐霜】【原创不易，请尊重版权】之后，这个容器实例就自动拥有了一些方法，【本文受版权保护】【原创内容，转载请注明出处】assert方法就是需要介绍的第一个方法著作权归作者所有，禁止商业用途转载。转载请注明出处：www.tangshuang.net。

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

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

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

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

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

【转载请注明来源】原创内容，盗版必究。原创内容，盗版必究。

assert接收的参数个数，和new T未经授权，禁止复制转载。本文版权归作者所有，未经授权不得转载。ype时接收的参数个数必须相同，如果不同未经授权，禁止复制转载。【版权所有，侵权必究】，也会抛出错误。因此，对参数个数具有严格【原创不易，请尊重版权】本文版权归作者所有，未经授权不得转载。的要求，你不能用assert一次性校验多【原创不易，请尊重版权】著作权归作者所有，禁止商业用途转载。个数据，只能反复调用assert来校验。

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

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

test【未经授权禁止转载】

【原创不易，请尊重版权】转载请注明出处：www.tangshuang.net【访问 www.tangshuang.net 获取更多精彩内容】【关注微信公众号：wwwtangshuangnet】原创内容，盗版必究。

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

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

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

catch方法会把捕获到的错误返回，如果本文版权归作者所有，未经授权不得转载。【关注微信公众号：wwwtangshuangnet】没有错误发生，就返回null。

转载请注明出处：www.tangshuang.net【未经授权禁止转载】【访问 www.tangshuang.net 获取更多精彩内容】

track.with转载请注明出处：www.tangshuang.net

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

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

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

使用这个语句，本身不会让程序终止，它在断【未经授权禁止转载】【转载请注明来源】言之后，如果发现不符合类型，就会执行fn【版权所有】唐霜 www.tangshuang.net【本文首发于唐霜的博客】，并把error传给fn。不过，如果在f本文版权归作者所有，未经授权不得转载。【版权所有，侵权必究】n中抛出错误就看你自己了。利用track【未经授权禁止转载】原创内容，盗版必究。.with，你就可以在不影响函数的正常执著作权归作者所有，禁止商业用途转载。【版权所有】唐霜 www.tangshuang.net行的情况下，还可以抓取到数据类型错误信息著作权归作者所有，禁止商业用途转载。【访问 www.tangshuang.net 获取更多精彩内容】。

原创内容，盗版必究。本文版权归作者所有，未经授权不得转载。【原创不易，请尊重版权】【本文受版权保护】

trace.with【版权所有】唐霜 www.tangshuang.net

未经授权，禁止复制转载。转载请注明出处：www.tangshuang.net本文版权归作者所有，未经授权不得转载。

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

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

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

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

严格模式【本文受版权保护】

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

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

转载请注明出处：www.tangshuang.net转载请注明出处：www.tangshuang.net【未经授权禁止转载】【本文首发于唐霜的博客】

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

PersonType.toBeStrict()

let StrictPersonType = PersonType.Strict

返回一个拷贝，而这个拷贝是严格模式的。s本文作者：唐霜，转载请注明出处。原创内容，盗版必究。trct和Strict是一模一样的，你也【未经授权禁止转载】【原创不易，请尊重版权】可以用someType.strict，只转载请注明出处：www.tangshuang.net【版权所有，侵权必究】是为了让使用的时候，根据不同开发者的习惯本文作者：唐霜，转载请注明出处。【本文首发于唐霜的博客】，提供大小写区别的方式。

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

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

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

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

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【关注微信公众号：wwwtangshuangnet】原创内容，盗版必究。ge设置了值，而严格模式下，被嵌套的容器转载请注明出处：www.tangshuang.net原创内容，盗版必究。也会转化为严格模式后再使用，因此，你不用著作权归作者所有，禁止商业用途转载。未经授权，禁止复制转载。自己手动嵌套一个严格模式的容器。而且，这原创内容，盗版必究。原创内容，盗版必究。种情况，SubType自身不会被切换为严著作权归作者所有，禁止商业用途转载。【原创内容，转载请注明出处】格模式，内部使用的是SubType.St原创内容，盗版必究。【作者：唐霜】rict，因此你可以放心使用。

本文作者：唐霜，转载请注明出处。【关注微信公众号：wwwtangshuangnet】未经授权，禁止复制转载。【原创不易，请尊重版权】

扩展数据类型【转载请注明来源】

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

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

下面这些扩展类型的本质还是“规则”，它们未经授权，禁止复制转载。著作权归作者所有，禁止商业用途转载。本身不是对数据类型的扩展，不是新的数据结本文作者：唐霜，转载请注明出处。【本文首发于唐霜的博客】构，而是创建一个对特定值进行类型约束的容本文作者：唐霜，转载请注明出处。【转载请注明来源】器。因此，它们全部是函数，而非类。

【访问 www.tangshuang.net 获取更多精彩内容】【作者：唐霜】原创内容，盗版必究。【未经授权禁止转载】

Dict 字典【作者：唐霜】

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

Dict是一个函数，接收一个对象型式，返【版权所有，侵权必究】著作权归作者所有，禁止商业用途转载。回一个容器

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

【作者：唐霜】

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

不传参数时，默认表示要断言的值必须是一个【原创内容，转载请注明出处】未经授权，禁止复制转载。对象，内部结构不校验

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

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

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

传入的型式不是一个对象的时候，相当于没有【版权所有，侵权必究】著作权归作者所有，禁止商业用途转载。传参数

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

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

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

支持嵌套【作者：唐霜】

【关注微信公众号：wwwtangshuangnet】

【未经授权禁止转载】

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

在Type的基础上，所有扩展类型都做了强未经授权，禁止复制转载。【原创不易，请尊重版权】规定，这样保证这些类型的特殊性。

著作权归作者所有，禁止商业用途转载。【原创不易，请尊重版权】【关注微信公众号：wwwtangshuangnet】【未经授权禁止转载】

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

这样就得到一个Dict的容器。它和一个n未经授权，禁止复制转载。转载请注明出处：www.tangshuang.netew Type的普通容器是一样的，只是在【访问 www.tangshuang.net 获取更多精彩内容】本文作者：唐霜，转载请注明出处。它的基础上加了一些强制而已，其他没有区别【关注微信公众号：wwwtangshuangnet】未经授权，禁止复制转载。。

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

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

Dict除了通用的判断方法外，还另外有两【访问 www.tangshuang.net 获取更多精彩内容】未经授权，禁止复制转载。个特别的方法。extends方法用于对原【关注微信公众号：wwwtangshuangnet】【原创内容，转载请注明出处】有的规则结构进行扩展，例如，你定义了一个原创内容，盗版必究。【关注微信公众号：wwwtangshuangnet】PersonType，但是你现在需要一个【转载请注明来源】【版权所有，侵权必究】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的参数是新增的属性及其规则【未经授权禁止转载】著作权归作者所有，禁止商业用途转载。。也可以通过extends对原有的规则进【本文首发于唐霜的博客】【关注微信公众号：wwwtangshuangnet】行覆盖，当原有类型中存在某个属性时，新给【版权所有】唐霜 www.tangshuang.net【原创内容，转载请注明出处】定当属性规则会覆盖原有的规则。它返回一个【关注微信公众号：wwwtangshuangnet】未经授权，禁止复制转载。新的Dict。

【转载请注明来源】转载请注明出处：www.tangshuang.net未经授权，禁止复制转载。转载请注明出处：www.tangshuang.net

extract【版权所有，侵权必究】

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

和extends相反，extract则是著作权归作者所有，禁止商业用途转载。著作权归作者所有，禁止商业用途转载。从原有的某些属性中抽取部分作为新的规则集【未经授权禁止转载】著作权归作者所有，禁止商业用途转载。合。它的使用方法如下：

原创内容，盗版必究。【转载请注明来源】【本文受版权保护】本文版权归作者所有，未经授权不得转载。

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

其中，值为true表示在新的ChildT【本文受版权保护】本文版权归作者所有，未经授权不得转载。ype中，这个属性的规则将会被使用，为f【转载请注明来源】【版权所有】唐霜 www.tangshuang.netalse将会被舍弃。但是，你可能会问，假著作权归作者所有，禁止商业用途转载。【版权所有】唐霜 www.tangshuang.net如在ParentType中的属性，在使用本文版权归作者所有，未经授权不得转载。【关注微信公众号：wwwtangshuangnet】extract的时候没有传入怎么办？这种【作者：唐霜】转载请注明出处：www.tangshuang.net情况会有一个规则去自适配：

当extract的参数中全部都为fals【关注微信公众号：wwwtangshuangnet】【版权所有】唐霜 www.tangshuang.nete时，表示这些属性会在新容器中全部被舍弃【未经授权禁止转载】【本文受版权保护】，而那些没有被提及的属性会全部被保留下来

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

原创内容，盗版必究。

当extract的参数中全部都为true原创内容，盗版必究。【本文首发于唐霜的博客】时，表示这些属性会被保留下来，所有没有被原创内容，盗版必究。【本文受版权保护】提及的属性都会被舍弃

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

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

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

【访问 www.tangshuang.net 获取更多精彩内容】

当参数中部分为true部分为false时【原创不易，请尊重版权】转载请注明出处：www.tangshuang.net，没有提及的属性会被舍弃（相当于只会保留【关注微信公众号：wwwtangshuangnet】【访问 www.tangshuang.net 获取更多精彩内容】被设置了true的那些属性，因此，这种写【未经授权禁止转载】【访问 www.tangshuang.net 获取更多精彩内容】法没有什么意义，一般而言，只需要全部为t【关注微信公众号：wwwtangshuangnet】原创内容，盗版必究。rue或者全部为false）

【关注微信公众号：wwwtangshuangnet】

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

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

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

List对应数组，它规定一个数组的每个位本文作者：唐霜，转载请注明出处。转载请注明出处：www.tangshuang.net置上元素的类型。

【原创内容，转载请注明出处】【原创不易，请尊重版权】【未经授权禁止转载】

List是一个函数，接收一个数组型式，返【未经授权禁止转载】【转载请注明来源】回一个容器

【本文受版权保护】

【未经授权禁止转载】

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

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

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

转载请注明出处：www.tangshuang.net

【本文受版权保护】

传的不是数组时，相当于没传转载请注明出处：www.tangshuang.net

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

【未经授权禁止转载】

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

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

支持嵌套未经授权，禁止复制转载。

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

【未经授权禁止转载】

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

原创内容，盗版必究。

const ListType = List([String, Number])

List的校验规则如下：【原创不易，请尊重版权】

检查是否是数组【未经授权禁止转载】

【转载请注明来源】

【访问 www.tangshuang.net 获取更多精彩内容】

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

【关注微信公众号：wwwtangshuangnet】

原创内容，盗版必究。

【访问 www.tangshuang.net 获取更多精彩内容】

检查数组元素的内部结构（元素类型检查）未经授权，禁止复制转载。

原创内容，盗版必究。

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

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

【作者：唐霜】

当被校验数组的长度超出规定长度时，严格模著作权归作者所有，禁止商业用途转载。【关注微信公众号：wwwtangshuangnet】式会不通过

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

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

【作者：唐霜】

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

兼容模式下，要求超出部分的元素必须是前面本文作者：唐霜，转载请注明出处。本文作者：唐霜，转载请注明出处。所规定的类型中的一个，也就是Enum(S转载请注明出处：www.tangshuang.net本文版权归作者所有，未经授权不得转载。tring, Number)

【访问 www.tangshuang.net 获取更多精彩内容】

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

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

Enum 枚举【访问 www.tangshuang.net 获取更多精彩内容】

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

枚举在js里面本身是没有的，我扩展出来，原创内容，盗版必究。【未经授权禁止转载】在HelloType体系里非常有用。它很【转载请注明来源】【未经授权禁止转载】简单，要求要校验的值，会用规定的几个规则【未经授权禁止转载】转载请注明出处：www.tangshuang.net中的一个去校验：

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

const EnumType = Enum(String, Number, Boolean)

本文作者：唐霜，转载请注明出处。【原创不易，请尊重版权】未经授权，禁止复制转载。原创内容，盗版必究。

不过一般而言，很少会这样用，因为我们并不【本文首发于唐霜的博客】本文版权归作者所有，未经授权不得转载。希望一个值是多类型的，我们更多的用法是：

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

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

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

枚举是一个超级好用的类型，它可以帮助你实【作者：唐霜】【原创内容，转载请注明出处】现各种花式操作，例如：

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

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

这个函数，乍一看是个加法运算，但是在js原创内容，盗版必究。原创内容，盗版必究。里面，字符串连接也是这样，所以，这就比较未经授权，禁止复制转载。本文作者：唐霜，转载请注明出处。麻烦了，两种数据类型都是允许的，但是假如【作者：唐霜】原创内容，盗版必究。，你只想它是其中的一种，你可以这样：

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

Tuple 元组【作者：唐霜】

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

元组是指一组散列的数据，按照一定的顺序组【原创内容，转载请注明出处】原创内容，盗版必究。成一组。它非常适合用来校验函数的参数。

Tuple是一个函数，接收任意数量的任意【版权所有，侵权必究】本文版权归作者所有，未经授权不得转载。类型的型式，返回一个容器

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

【本文受版权保护】

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

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

不支持嵌套【访问 www.tangshuang.net 获取更多精彩内容】

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

【转载请注明来源】

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

const TupleType = Tuple(String, Number)

它非常使用函数参数校验，因为有的时候，你【原创内容，转载请注明出处】本文作者：唐霜，转载请注明出处。并不知道函数参数会传多少个，你会这样做：

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

因为Tuple可以校验一组值，而非一个值著作权归作者所有，禁止商业用途转载。本文版权归作者所有，未经授权不得转载。，所以它很适合这种校验。它的校验规则如下【访问 www.tangshuang.net 获取更多精彩内容】本文作者：唐霜，转载请注明出处。：

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

校验传入的参数的个数，如果传入参数个数不【版权所有，侵权必究】著作权归作者所有，禁止商业用途转载。一样，不通过

【访问 www.tangshuang.net 获取更多精彩内容】

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

转载请注明出处：www.tangshuang.net

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

校验每个位置上的数据类型转载请注明出处：www.tangshuang.net

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

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

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

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

【访问 www.tangshuang.net 获取更多精彩内容】【转载请注明来源】【访问 www.tangshuang.net 获取更多精彩内容】

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

注意，如果不是尾部的IfExists，它【本文受版权保护】著作权归作者所有，禁止商业用途转载。会被强制校验。

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

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

转载请注明出处：www.tangshuang.net本文作者：唐霜，转载请注明出处。【原创内容，转载请注明出处】转载请注明出处：www.tangshuang.net【未经授权禁止转载】

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

它是一个函数，接收两个数字，第一个表示最本文版权归作者所有，未经授权不得转载。【本文受版权保护】小值，第二个表示最大值，返回一个容器

原创内容，盗版必究。

【未经授权禁止转载】

最小值和最大值都必须是数字，如果不是数字转载请注明出处：www.tangshuang.net【版权所有】唐霜 www.tangshuang.net，会被分别转化为0和1

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

【关注微信公众号：wwwtangshuangnet】

【转载请注明来源】

【作者：唐霜】

最小值必须小于等于最大值，如果最小值大于未经授权，禁止复制转载。本文版权归作者所有，未经授权不得转载。最大值，会被强制转化为最大值相等数值后使著作权归作者所有，禁止商业用途转载。本文版权归作者所有，未经授权不得转载。用

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

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

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

const RangeType = Range(0, 100)

上面的RangeType要求被校验的是数未经授权，禁止复制转载。著作权归作者所有，禁止商业用途转载。字，且必须处于[0, 100]之间（包含【访问 www.tangshuang.net 获取更多精彩内容】【原创内容，转载请注明出处】0和100）。

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

自定义类型【作者：唐霜】

未经授权，禁止复制转载。本文作者：唐霜，转载请注明出处。本文作者：唐霜，转载请注明出处。【原创内容，转载请注明出处】【关注微信公众号：wwwtangshuangnet】

你也可以写出自己的自定义类型，其实构建一未经授权，禁止复制转载。【访问 www.tangshuang.net 获取更多精彩内容】个自定义类型非常简单，你可以查看Dict【版权所有】唐霜 www.tangshuang.net本文作者：唐霜，转载请注明出处。的源码，它干了两件事，一是规定了函数传入【转载请注明来源】【版权所有，侵权必究】参数的限制，另一件事是创建一个容器，这个原创内容，盗版必究。【原创内容，转载请注明出处】容器具有特殊的校验规则，并给它赋一个na原创内容，盗版必究。转载请注明出处：www.tangshuang.netme。例如，我现在要扩展出一个只允许包含【原创不易，请尊重版权】【原创不易，请尊重版权】两个元素，且都是数字的数组的类型：

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

利用已有的各种素材，可以创建任何类型。本文版权归作者所有，未经授权不得转载。

【转载请注明来源】【关注微信公众号：wwwtangshuangnet】本文版权归作者所有，未经授权不得转载。著作权归作者所有，禁止商业用途转载。未经授权，禁止复制转载。

Rule【版权所有】唐霜 www.tangshuang.net

【访问 www.tangshuang.net 获取更多精彩内容】原创内容，盗版必究。【转载请注明来源】【未经授权禁止转载】转载请注明出处：www.tangshuang.net

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

constructor【本文受版权保护】

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

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

import { Rule } from 'hello-type'

它接收一个参数，这个参数是一个函数，函数本文作者：唐霜，转载请注明出处。【转载请注明来源】可以包含一个参数，这个参数就是要校验的值【未经授权禁止转载】本文作者：唐霜，转载请注明出处。。这个函数可以返回任意内容，但是，当你校【版权所有】唐霜 www.tangshuang.net【关注微信公众号：wwwtangshuangnet】验失败时，必须返回一个Error/Typ【原创内容，转载请注明出处】本文作者：唐霜，转载请注明出处。eError实例，当HelloType发【本文受版权保护】【转载请注明来源】现你返回的是Error的实例的时候，就认本文作者：唐霜，转载请注明出处。【作者：唐霜】为校验失败，并抛出错误：

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

非常简单。不过它也可以接收两个参数，第一【未经授权禁止转载】原创内容，盗版必究。个参数可以是一个字符串，用来给这个Rul【本文首发于唐霜的博客】原创内容，盗版必究。e命名：

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

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

=== 注意：以下内容有点危险 ===转载请注明出处：www.tangshuang.net

Rule构造器还可以接收第三个参数，但是【本文受版权保护】【原创内容，转载请注明出处】这个参数有点危险，请谨慎使用。第三个参数【关注微信公众号：wwwtangshuangnet】【本文受版权保护】用来覆盖当前属性的值。它仅对对象属性、数【本文受版权保护】【访问 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【未经授权禁止转载】【访问 www.tangshuang.net 获取更多精彩内容】

第三个函数有三个参数【本文受版权保护】

【访问 www.tangshuang.net 获取更多精彩内容】【关注微信公众号：wwwtangshuangnet】【关注微信公众号：wwwtangshuangnet】【访问 www.tangshuang.net 获取更多精彩内容】

error 第二个函数的返回值，看你自己著作权归作者所有，禁止商业用途转载。【访问 www.tangshuang.net 获取更多精彩内容】在第二个函数中怎么返回

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

转载请注明出处：www.tangshuang.net

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

【未经授权禁止转载】

prop 正在检查哪一个对象的什么属性【未经授权禁止转载】

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

target 正在检查哪一个对象【原创不易，请尊重版权】

转载请注明出处：www.tangshuang.net

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

【作者：唐霜】

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

【本文受版权保护】

但是你应该注意到，在第三个函数中，我使用转载请注明出处：www.tangshuang.net【本文受版权保护】了target[prop] = {}，直【转载请注明来源】本文作者：唐霜，转载请注明出处。接修改了原始数据中的内容，这一点你要千万【未经授权禁止转载】【关注微信公众号：wwwtangshuangnet】小心，这个操作修改了原始值，因此你一定要【版权所有，侵权必究】【原创不易，请尊重版权】在知道发生了什么的情况下使用。

转载请注明出处：www.tangshuang.net【本文首发于唐霜的博客】【本文首发于唐霜的博客】【作者：唐霜】

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

在最前面的章节里我已经介绍到了这Null【访问 www.tangshuang.net 获取更多精彩内容】【作者：唐霜】、Undefined、Any这三个被扩展原创内容，盗版必究。【本文受版权保护】出来的原型。

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

原创内容，盗版必究。【未经授权禁止转载】原创内容，盗版必究。【原创不易，请尊重版权】【原创内容，转载请注明出处】

要校验的值必须是null。未经授权，禁止复制转载。

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

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

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

要校验的值必须是undefined。著作权归作者所有，禁止商业用途转载。

【本文首发于唐霜的博客】转载请注明出处：www.tangshuang.net【原创不易，请尊重版权】

Any【未经授权禁止转载】

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

要校验的值可以是任何类型。【关注微信公众号：wwwtangshuangnet】

【转载请注明来源】未经授权，禁止复制转载。【关注微信公众号：wwwtangshuangnet】

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

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

基于Rule可以制作出任意的扩展类型。在著作权归作者所有，禁止商业用途转载。未经授权，禁止复制转载。这个思路下，你可以在自己的项目中去创建自【本文受版权保护】本文作者：唐霜，转载请注明出处。己的很多原型，例如创建某个时间格式的原型【转载请注明来源】【作者：唐霜】等。

未经授权，禁止复制转载。转载请注明出处：www.tangshuang.net【转载请注明来源】

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

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

我在HelloType中内置了几种规则，【作者：唐霜】原创内容，盗版必究。把常见的一些情况考虑进去，当然，考虑的不【本文首发于唐霜的博客】【本文首发于唐霜的博客】够全面，如果你有认为需要改进的地方，可以【关注微信公众号：wwwtangshuangnet】著作权归作者所有，禁止商业用途转载。给我提出需求，我可以根据情况，把你提出的本文版权归作者所有，未经授权不得转载。【访问 www.tangshuang.net 获取更多精彩内容】规则内置进去。

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

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

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

这一些情况下，你希望有些值是可选的，比如原创内容，盗版必究。【原创不易，请尊重版权】一个对象的某个属性，你希望如果这个属性存本文版权归作者所有，未经授权不得转载。本文版权归作者所有，未经授权不得转载。在，就校验它，如果不存在，就直接略过。数【未经授权禁止转载】转载请注明出处：www.tangshuang.net组也是一样，你希望一个数组如果是空数组，【转载请注明来源】【本文首发于唐霜的博客】就直接略过，如果这个数组有元素，那么要求原创内容，盗版必究。著作权归作者所有，禁止商业用途转载。它每个元素都是一个字符串。这样的需求比较【原创内容，转载请注明出处】原创内容，盗版必究。常见。

那么怎么做到呢？就要借助IfExists【本文首发于唐霜的博客】本文版权归作者所有，未经授权不得转载。。

原创内容，盗版必究。原创内容，盗版必究。【原创内容，转载请注明出处】

IfExists是一个函数，接收一个规则【本文受版权保护】【作者：唐霜】作为参数，返回一个规则

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

【本文受版权保护】

当要校验的值存在时，它必须满足IfExi本文版权归作者所有，未经授权不得转载。【版权所有】唐霜 www.tangshuang.netsts参数中的规则

转载请注明出处：www.tangshuang.net

【作者：唐霜】

【本文受版权保护】

【转载请注明来源】

如果不存在，则直接忽略著作权归作者所有，禁止商业用途转载。

转载请注明出处：www.tangshuang.net

【访问 www.tangshuang.net 获取更多精彩内容】

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

严格模式下IfExists失效，被校验值原创内容，盗版必究。【原创内容，转载请注明出处】必须满足IfExists接收的第一个参数未经授权，禁止复制转载。转载请注明出处：www.tangshuang.net中的规则

原创内容，盗版必究。

【转载请注明来源】

原创内容，盗版必究。

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

严格模式下的时候，要特别注意，IfExi【转载请注明来源】原创内容，盗版必究。sts会失效，因此，如果你用SomeTy【作者：唐霜】原创内容，盗版必究。pe的严格模式，age必须是一个数字。

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

在Tuple, List中使用IfExi未经授权，禁止复制转载。【原创不易，请尊重版权】sts有特殊性，Tuple只会让末尾的I【未经授权禁止转载】原创内容，盗版必究。fExists生效：

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

InstanceOf【未经授权禁止转载】

这个规则用于校验被校验值是否是传入值的一本文作者：唐霜，转载请注明出处。著作权归作者所有，禁止商业用途转载。个实例。

InstanceOf是一个函数，接收一个【原创内容，转载请注明出处】原创内容，盗版必究。参数，这个参数必须是一个构造器，返回一个【访问 www.tangshuang.net 获取更多精彩内容】本文作者：唐霜，转载请注明出处。规则

转载请注明出处：www.tangshuang.net

【本文受版权保护】

【转载请注明来源】

【未经授权禁止转载】

【作者：唐霜】

在HelloType中String，Nu【版权所有，侵权必究】【本文首发于唐霜的博客】mber，Boolean，Object都【关注微信公众号：wwwtangshuangnet】【转载请注明来源】做了强制，因此，当你想要判断一个值是否是【原创不易，请尊重版权】本文版权归作者所有，未经授权不得转载。new String出来的怎么办呢？这个【版权所有】唐霜 www.tangshuang.net【版权所有，侵权必究】时候就得借助InstanceOf：

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

由于HelloType内部本身就会去校验著作权归作者所有，禁止商业用途转载。本文版权归作者所有，未经授权不得转载。一个对象是否是给出的规则类的一个实例，所【转载请注明来源】本文作者：唐霜，转载请注明出处。以，在校验是否是实例的时候其实不需要专门转载请注明出处：www.tangshuang.net【原创内容，转载请注明出处】使用InstanceOf:

const ins = new MyClass()

const MyClassType = new Type(MyClass)

MyClassType.assert(ins) // ok

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

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

Equal【版权所有】唐霜 www.tangshuang.net

【未经授权禁止转载】著作权归作者所有，禁止商业用途转载。转载请注明出处：www.tangshuang.net

在HelloType的校验中，虽然会先校本文作者：唐霜，转载请注明出处。【访问 www.tangshuang.net 获取更多精彩内容】验一个值是否与规定的值相等，然后再考虑其本文作者：唐霜，转载请注明出处。原创内容，盗版必究。他校验规则。而String，Number【版权所有】唐霜 www.tangshuang.net本文版权归作者所有，未经授权不得转载。，Boolean，Object都被做了强【未经授权禁止转载】本文作者：唐霜，转载请注明出处。制，因此，如果你这样做：

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

只会得到一个错误，所以，在这种情况下，默未经授权，禁止复制转载。原创内容，盗版必究。认的相等规则失效了，这个时候就需要借助E【未经授权禁止转载】著作权归作者所有，禁止商业用途转载。qual：

【访问 www.tangshuang.net 获取更多精彩内容】【未经授权禁止转载】【关注微信公众号：wwwtangshuangnet】【作者：唐霜】本文版权归作者所有，未经授权不得转载。

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

IfNotMatch【访问 www.tangshuang.net 获取更多精彩内容】

【原创不易，请尊重版权】本文版权归作者所有，未经授权不得转载。著作权归作者所有，禁止商业用途转载。

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

本文版权归作者所有，未经授权不得转载。【访问 www.tangshuang.net 获取更多精彩内容】【本文受版权保护】【转载请注明来源】本文版权归作者所有，未经授权不得转载。

IfNotMatch是一个函数，接收两个【本文首发于唐霜的博客】本文作者：唐霜，转载请注明出处。参数，

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

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

第一个参数rule是要检查的类型规则，原创内容，盗版必究。

【关注微信公众号：wwwtangshuangnet】

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

转载请注明出处：www.tangshuang.net

【未经授权禁止转载】

第二个参数defaultValue是在不【关注微信公众号：wwwtangshuangnet】【访问 www.tangshuang.net 获取更多精彩内容】通过校验的情况下用什么值覆盖，可选

转载请注明出处：www.tangshuang.net

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

第三个参数，可选，一个函数，接收原始值和【关注微信公众号：wwwtangshuangnet】转载请注明出处：www.tangshuang.net你传的defaultValue作为参数，本文作者：唐霜，转载请注明出处。【本文首发于唐霜的博客】返回值将替换该属性的值

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

【访问 www.tangshuang.net 获取更多精彩内容】

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

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

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

虽然上面的这句话很像IfExists，但【本文受版权保护】【本文受版权保护】是并不是，IfExists是允许chil【未经授权禁止转载】【转载请注明来源】dren不存在，而IfNotMatch要著作权归作者所有，禁止商业用途转载。未经授权，禁止复制转载。求children必须存在，如果不存在，转载请注明出处：www.tangshuang.net【访问 www.tangshuang.net 获取更多精彩内容】或者说它不满足List([Object]【转载请注明来源】未经授权，禁止复制转载。)，就会用一个空数组去代替。

【本文首发于唐霜的博客】著作权归作者所有，禁止商业用途转载。【未经授权禁止转载】【作者：唐霜】【本文受版权保护】

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著作权归作者所有，禁止商业用途转载。【原创内容，转载请注明出处】Match就用了这第三个危险的参数，它会本文作者：唐霜，转载请注明出处。【原创不易，请尊重版权】修改你的原始值，因此在使用的时候要特别小本文作者：唐霜，转载请注明出处。【版权所有】唐霜 www.tangshuang.net心。举个例子，你不能在使用trace的场转载请注明出处：www.tangshuang.net转载请注明出处：www.tangshuang.net景下使用IfNotMatch，因为tra【版权所有】唐霜 www.tangshuang.net【本文首发于唐霜的博客】ce会异步执行代码，如果你这个时候使用I【转载请注明来源】本文版权归作者所有，未经授权不得转载。fNotMatch的第二个参数defau【未经授权禁止转载】【关注微信公众号：wwwtangshuangnet】ltValue去覆盖，你会发现，覆盖动作【版权所有】唐霜 www.tangshuang.net【原创不易，请尊重版权】位于你整个程序时序的最后，这个时候，bu【版权所有】唐霜 www.tangshuang.net转载请注明出处：www.tangshuang.netg可能已经产生了。最大的建议，就是尽可能不要用IfNotM著作权归作者所有，禁止商业用途转载。【访问 www.tangshuang.net 获取更多精彩内容】atch。【转载请注明来源】

【转载请注明来源】【本文首发于唐霜的博客】转载请注明出处：www.tangshuang.net转载请注明出处：www.tangshuang.net本文作者：唐霜，转载请注明出处。

IfExistsNotMatch【转载请注明来源】

【本文受版权保护】【未经授权禁止转载】【原创不易，请尊重版权】本文版权归作者所有，未经授权不得转载。转载请注明出处：www.tangshuang.net

相当于IfExists和IfNotMat【本文受版权保护】【版权所有，侵权必究】ch的组合。当一个属性不存在时，直接忽视本文作者：唐霜，转载请注明出处。【访问 www.tangshuang.net 获取更多精彩内容】这条规则，不进行校验。而如果存在的情况下【未经授权禁止转载】转载请注明出处：www.tangshuang.net，就要进行校验，同时，如果校验失败，用新【关注微信公众号：wwwtangshuangnet】【访问 www.tangshuang.net 获取更多精彩内容】值去替代原始值。

转载请注明出处：www.tangshuang.net【本文受版权保护】【转载请注明来源】【原创不易，请尊重版权】

IfExistsNotMatch是一个函【关注微信公众号：wwwtangshuangnet】【版权所有】唐霜 www.tangshuang.net数，接收两个参数，

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

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

原创内容，盗版必究。

第一个参数rule是要检查的类型规则，【版权所有，侵权必究】

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

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

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

第二个参数defaultValue是在不【本文受版权保护】【本文首发于唐霜的博客】通过校验的情况下用什么值覆盖，可选

【访问 www.tangshuang.net 获取更多精彩内容】

【关注微信公众号：wwwtangshuangnet】

第三个参数，可选，一个函数，接收原始值和【版权所有】唐霜 www.tangshuang.net【作者：唐霜】你传的defaultValue作为参数，【访问 www.tangshuang.net 获取更多精彩内容】【版权所有，侵权必究】返回值将替换该属性的值

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

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

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

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

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

Lambda【本文受版权保护】

这个规则非常微妙，虽然我不推荐你使用它，【作者：唐霜】转载请注明出处：www.tangshuang.net但是我希望你知道它的思想，这样你可以更好本文作者：唐霜，转载请注明出处。【未经授权禁止转载】的使用HelloType。Lambda会本文版权归作者所有，未经授权不得转载。【原创内容，转载请注明出处】检查当前值是否是一个函数，如果是函数的话原创内容，盗版必究。本文版权归作者所有，未经授权不得转载。，会重写这个函数，并且用输入和输出规则进转载请注明出处：www.tangshuang.net【原创不易，请尊重版权】行校验。

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

Lambda是一个函数，接收两个参数【版权所有】唐霜 www.tangshuang.net

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

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

【访问 www.tangshuang.net 获取更多精彩内容】

第一个参数是输入值的规则，如果你的函数要【作者：唐霜】著作权归作者所有，禁止商业用途转载。求输入多个值，要用Tuple

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

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

原创内容，盗版必究。

【作者：唐霜】

第二个参数是输出值的规则【版权所有】唐霜 www.tangshuang.net

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

转载请注明出处：www.tangshuang.net

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

原创内容，盗版必究。

它要求值首先得是一个函数，其次它在运行过【作者：唐霜】【作者：唐霜】程中，输入输出都必须符合要求

【转载请注明来源】

原创内容，盗版必究。

【转载请注明来源】

如果任何一点校验失败，都会抛出错误，函数【转载请注明来源】【版权所有】唐霜 www.tangshuang.net的执行被中断，你得不到任何结果

【作者：唐霜】

原创内容，盗版必究。

只对对象属性、数组元素生效未经授权，禁止复制转载。

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

转载请注明出处：www.tangshuang.net

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

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

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

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

Validate：自定义消息未经授权，禁止复制转载。

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

这个规则更适合用来做自定义消息，它非常有本文作者：唐霜，转载请注明出处。【本文首发于唐霜的博客】利于降级HelloType的概念，让基础本文版权归作者所有，未经授权不得转载。【版权所有】唐霜 www.tangshuang.net开发者不必深入了解HelloType的理本文版权归作者所有，未经授权不得转载。【本文首发于唐霜的博客】念，从业务中逐渐过度HelloType的著作权归作者所有，禁止商业用途转载。【原创不易，请尊重版权】使用方法，我们来看一个例子：

【关注微信公众号：wwwtangshuangnet】转载请注明出处：www.tangshuang.net转载请注明出处：www.tangshuang.net【本文受版权保护】

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

上面规定了一个对象的三个字段的类型，在具【本文首发于唐霜的博客】【原创内容，转载请注明出处】体业务中，这个对象可能是表单要提交的对象本文作者：唐霜，转载请注明出处。【本文首发于唐霜的博客】，利用这种方式，可以很好的做表单检查：

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

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

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

【关注微信公众号：wwwtangshuangnet】【本文首发于唐霜的博客】【关注微信公众号：wwwtangshuangnet】【本文首发于唐霜的博客】【原创内容，转载请注明出处】

Validate函数的参数如下：【原创不易，请尊重版权】

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

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

【关注微信公众号：wwwtangshuangnet】

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

【本文受版权保护】

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

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

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

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

转载请注明出处：www.tangshuang.net

原创内容，盗版必究。

Determine：条件选择【原创不易，请尊重版权】

【原创不易，请尊重版权】【本文首发于唐霜的博客】【作者：唐霜】原创内容，盗版必究。【访问 www.tangshuang.net 获取更多精彩内容】

这个规则主要用来根据当前属性所在的对象进【未经授权禁止转载】未经授权，禁止复制转载。行条件选择，根据对象上其他属性的判断来确【原创不易，请尊重版权】【本文首发于唐霜的博客】定当前这个属性应该是什么类型。比如，当前本文作者：唐霜，转载请注明出处。【版权所有】唐霜 www.tangshuang.net这个对象是一个person，而它有一个属【访问 www.tangshuang.net 获取更多精彩内容】【版权所有】唐霜 www.tangshuang.net性叫mustache（胡子），显然，女人【版权所有，侵权必究】著作权归作者所有，禁止商业用途转载。是不可能有胡子的，因此，要决定musta【未经授权禁止转载】【版权所有】唐霜 www.tangshuang.netche的值的类型，需要依赖于对性别的检查原创内容，盗版必究。【关注微信公众号：wwwtangshuangnet】。那么这种情况下，就可以使用Determ【作者：唐霜】转载请注明出处：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
    }
  }),
})

上面这段代码，当这个人是一个男人的时候，本文作者：唐霜，转载请注明出处。原创内容，盗版必究。要求mustache属性必须是一个数字，原创内容，盗版必究。未经授权，禁止复制转载。否则必须为Null。

转载请注明出处：www.tangshuang.net【转载请注明来源】【作者：唐霜】【作者：唐霜】

Determine函数的具体参数如下：原创内容，盗版必究。

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

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

【关注微信公众号：wwwtangshuangnet】

【访问 www.tangshuang.net 获取更多精彩内容】

【未经授权禁止转载】

@return Determine返回一著作权归作者所有，禁止商业用途转载。【作者：唐霜】个Rule的实例

【作者：唐霜】

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

【未经授权禁止转载】

Async【本文受版权保护】

转载请注明出处：www.tangshuang.net【未经授权禁止转载】【原创内容，转载请注明出处】【本文受版权保护】

Async规则也是一个函数，它生成一个特【转载请注明来源】【访问 www.tangshuang.net 获取更多精彩内容】殊的规则，这个规则在默认情况下永远返回t【作者：唐霜】【访问 www.tangshuang.net 获取更多精彩内容】rue，即不会造成任何校验错误。但是你需本文版权归作者所有，未经授权不得转载。原创内容，盗版必究。要向它传一个函数，这个函数里面进行异步操【关注微信公众号：wwwtangshuangnet】转载请注明出处：www.tangshuang.net作，通过返回Promise来返回一个规则【转载请注明来源】【关注微信公众号：wwwtangshuangnet】，当Promise resolved之后【访问 www.tangshuang.net 获取更多精彩内容】【版权所有】唐霜 www.tangshuang.net，这个返回的规则会替代原有规则，成为新规【版权所有】唐霜 www.tangshuang.net未经授权，禁止复制转载。则。

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

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

【作者：唐霜】本文版权归作者所有，未经授权不得转载。【访问 www.tangshuang.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)

上面这段代码，很好演示了在异步校验场景的本文作者：唐霜，转载请注明出处。原创内容，盗版必究。应用。

ShouldMatch：同时满足多个未经授权，禁止复制转载。

原创内容，盗版必究。【转载请注明来源】【作者：唐霜】【本文受版权保护】【本文首发于唐霜的博客】

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

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

…rules: 规则列表，你转载请注明出处：www.tangshuang.net转载请注明出处：www.tangshuang.net可以传入任意多个规则，这些规则按照顺序被转载请注明出处：www.tangshuang.net转载请注明出处：www.tangshuang.net检查，只有全部通过检查之后，Should【访问 www.tangshuang.net 获取更多精彩内容】本文作者：唐霜，转载请注明出处。Match才算通过

【未经授权禁止转载】

【关注微信公众号：wwwtangshuangnet】

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.netValidate规则只能规定一个mess【访问 www.tangshuang.net 获取更多精彩内容】原创内容，盗版必究。age，但是，有的时候，你需要针对不同的【作者：唐霜】【原创内容，转载请注明出处】检查结果给出不同的message，这个时原创内容，盗版必究。著作权归作者所有，禁止商业用途转载。候，可以将Validate拆分，并配合S著作权归作者所有，禁止商业用途转载。【作者：唐霜】houldMatch来用，就可以非常方便【版权所有，侵权必究】原创内容，盗版必究。的实现这个目的。

【访问 www.tangshuang.net 获取更多精彩内容】【转载请注明来源】【访问 www.tangshuang.net 获取更多精彩内容】

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

这个规则生成器的厉害之处在于，可以通过一【本文首发于唐霜的博客】本文作者：唐霜，转载请注明出处。个条件去决定该属性是否可以不存在。听上去【作者：唐霜】【作者：唐霜】，逻辑是反的，但是事实时，在某些情况下，转载请注明出处：www.tangshuang.net【关注微信公众号：wwwtangshuangnet】你希望通过一个条件判断来决定这个属性是不未经授权，禁止复制转载。【转载请注明来源】是存在，如果存在的情况下会使用某个规则。【版权所有】唐霜 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会在决定这个属性是否本文作者：唐霜，转载请注明出处。【转载请注明来源】可以不存在时，多加来一层。

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

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

【未经授权禁止转载】

【作者：唐霜】

【本文受版权保护】

【访问 www.tangshuang.net 获取更多精彩内容】

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

【本文受版权保护】

转载请注明出处：www.tangshuang.net

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

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

这个方法在一些特别的情况下具有非常重要的【本文首发于唐霜的博客】【原创不易，请尊重版权】作用，例如，有些接口的某些字段，在接口返本文版权归作者所有，未经授权不得转载。本文版权归作者所有，未经授权不得转载。回的对象为某种类型时，有些字段不存在，而未经授权，禁止复制转载。未经授权，禁止复制转载。另外一些字段只有在该对象为特定类型是才会【访问 www.tangshuang.net 获取更多精彩内容】【原创不易，请尊重版权】存在，这是就可以用Determine来规原创内容，盗版必究。【未经授权禁止转载】定它的规则。

规则嵌套【未经授权禁止转载】

转载请注明出处：www.tangshuang.net【未经授权禁止转载】转载请注明出处：www.tangshuang.net未经授权，禁止复制转载。

规则可以相互嵌套，但也不尽然。有的时候逻转载请注明出处：www.tangshuang.net【作者：唐霜】辑很重要，特别是IfExists一般都会本文作者：唐霜，转载请注明出处。【转载请注明来源】嵌套规则，举个例子：

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

【本文首发于唐霜的博客】转载请注明出处：www.tangshuang.net【本文受版权保护】【关注微信公众号：wwwtangshuangnet】

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

这样也是一种形式。本文作者：唐霜，转载请注明出处。

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

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

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

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

HelloType辅助器原创内容，盗版必究。

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

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

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

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

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

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

expect.to.match【未经授权禁止转载】

它提供对某个目标值进行校验的方法。Hel【原创不易，请尊重版权】本文作者：唐霜，转载请注明出处。loType.expect.to.mat【本文首发于唐霜的博客】转载请注明出处：www.tangshuang.netch是assert方法的别称，例如：

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

这两者是一样的。虽然前面一句的句子长很多【关注微信公众号：wwwtangshuangnet】本文版权归作者所有，未经授权不得转载。，但是这主要是为了代码管理的方便。而且还【访问 www.tangshuang.net 获取更多精彩内容】【本文首发于唐霜的博客】有好处，先卖关子，后面会讲到。

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

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

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

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

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

track.by.with【本文首发于唐霜的博客】

【作者：唐霜】转载请注明出处：www.tangshuang.net本文版权归作者所有，未经授权不得转载。原创内容，盗版必究。

HelloType.track.by.w【本文受版权保护】【本文受版权保护】ith是track.with的别称：

本文版权归作者所有，未经授权不得转载。著作权归作者所有，禁止商业用途转载。【转载请注明来源】【关注微信公众号：wwwtangshuangnet】【访问 www.tangshuang.net 获取更多精彩内容】

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

trace.by.with未经授权，禁止复制转载。

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

【本文受版权保护】本文版权归作者所有，未经授权不得转载。转载请注明出处：www.tangshuang.net

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【原创内容，转载请注明出处】

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

本文版权归作者所有，未经授权不得转载。【本文受版权保护】【关注微信公众号：wwwtangshuangnet】【未经授权禁止转载】【关注微信公众号：wwwtangshuangnet】

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

of后面跟规则。本文作者：唐霜，转载请注明出处。

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

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

未经授权，禁止复制转载。【转载请注明来源】原创内容，盗版必究。本文版权归作者所有，未经授权不得转载。

ES7提供了装饰器的能力，用以对一个类及【原创内容，转载请注明出处】【关注微信公众号：wwwtangshuangnet】其成员进行装饰。这部分内容，对于比较熟悉【原创内容，转载请注明出处】【原创不易，请尊重版权】的开发者应该不陌生，如果你不熟悉，不使用【未经授权禁止转载】转载请注明出处：www.tangshuang.net也是没关系的。

本文版权归作者所有，未经授权不得转载。转载请注明出处：www.tangshuang.net【关注微信公众号：wwwtangshuangnet】转载请注明出处：www.tangshuang.net

with【转载请注明来源】

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

HelloType.decorate.w著作权归作者所有，禁止商业用途转载。【未经授权禁止转载】ith可以直接装饰类，也可以装饰属性成员【原创不易，请尊重版权】【本文首发于唐霜的博客】：

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

【访问 www.tangshuang.net 获取更多精彩内容】【本文受版权保护】【本文首发于唐霜的博客】【本文受版权保护】

input.with【作者：唐霜】

HelloType.decorate.i原创内容，盗版必究。转载请注明出处：www.tangshuang.netnput.with可以装饰方法成员，校验未经授权，禁止复制转载。【原创不易，请尊重版权】它的输入值：

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

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

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

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

HelloType.decorate.o【关注微信公众号：wwwtangshuangnet】本文版权归作者所有，未经授权不得转载。utput.with可以装饰方法成员，校【转载请注明来源】【作者：唐霜】验它的返回值：

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

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

小结【版权所有，侵权必究】

with后面除了可以直接传Type实例之【本文受版权保护】【原创不易，请尊重版权】外，还可以传一个函数，因为有的时候你不想未经授权，禁止复制转载。【访问 www.tangshuang.net 获取更多精彩内容】直接用容器去校验，而是有一定逻辑的去校验本文版权归作者所有，未经授权不得转载。【未经授权禁止转载】。函数怎么用呢？

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

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

总之，在你知道装饰器的情况下使用Hell本文版权归作者所有，未经授权不得转载。【作者：唐霜】oType.decorate，会让你的代本文作者：唐霜，转载请注明出处。本文版权归作者所有，未经授权不得转载。码减少侵入性。

define【转载请注明来源】

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

这需要注意，define不会修改原始值，【访问 www.tangshuang.net 获取更多精彩内容】【转载请注明来源】而是先克隆一个备份之后再赋值给obj。d【版权所有】唐霜 www.tangshuang.net【版权所有】唐霜 www.tangshuang.netefine的结果会自带规定的那些属性，例本文版权归作者所有，未经授权不得转载。本文版权归作者所有，未经授权不得转载。如obj.sub.key已经有了，虽然是【本文首发于唐霜的博客】本文版权归作者所有，未经授权不得转载。undefined，但是不会报错。

经过define之后，如果你进行赋值ob【原创不易，请尊重版权】【关注微信公众号：wwwtangshuangnet】j.sub.key = 10就会报错，因【原创内容，转载请注明出处】著作权归作者所有，禁止商业用途转载。为obj.sub.key必须是一个obj本文版权归作者所有，未经授权不得转载。【原创内容，转载请注明出处】ect。这个时候，你可能还会用上Lamb本文作者：唐霜，转载请注明出处。著作权归作者所有，禁止商业用途转载。da，可以往上翻看它的具体方法。

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

其他方法【本文首发于唐霜的博客】

转载请注明出处：www.tangshuang.net【关注微信公众号：wwwtangshuangnet】转载请注明出处：www.tangshuang.net

silent/Silent转载请注明出处：www.tangshuang.net

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

安静模式，仅对HelloType.exp未经授权，禁止复制转载。未经授权，禁止复制转载。ect.to.match有效，直接使用容转载请注明出处：www.tangshuang.net未经授权，禁止复制转载。器不会生效。所谓安静模式，意思是不通过t本文版权归作者所有，未经授权不得转载。【版权所有】唐霜 www.tangshuang.nethrow TypeError终止进程，但【访问 www.tangshuang.net 获取更多精彩内容】【未经授权禁止转载】是抛出错误。

【转载请注明来源】著作权归作者所有，禁止商业用途转载。原创内容，盗版必究。

开启安静模式下，你还可以通过bind绑定未经授权，禁止复制转载。原创内容，盗版必究。一个函数，用以收集错误。先看下开启安静模【未经授权禁止转载】转载请注明出处：www.tangshuang.net式：

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

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

未经授权，禁止复制转载。【转载请注明来源】本文版权归作者所有，未经授权不得转载。【作者：唐霜】

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

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

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

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

bind转载请注明出处：www.tangshuang.net

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

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

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

【本文首发于唐霜的博客】【转载请注明来源】转载请注明出处：www.tangshuang.net【关注微信公众号：wwwtangshuangnet】【本文受版权保护】

unbind【作者：唐霜】

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

unbind是bind的反函数，用以直接未经授权，禁止复制转载。著作权归作者所有，禁止商业用途转载。解除fn的绑定。解绑之后，抛出错误时，这本文版权归作者所有，未经授权不得转载。【作者：唐霜】个函数就不会执行了。

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

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

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

引入和使用【转载请注明来源】

想要使用HelloTypeError很简【转载请注明来源】【原创不易，请尊重版权】单，通过包引入即可：

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

import HelloType from 'hello-type'

let err = new HelloType.Error(message)

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

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

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

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

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

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

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

addtrace(traceinfo)【本文首发于唐霜的博客】

【访问 www.tangshuang.net 获取更多精彩内容】【关注微信公众号：wwwtangshuangnet】原创内容，盗版必究。

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

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

addtrace的参数是任意的对象，它只转载请注明出处：www.tangshuang.net原创内容，盗版必究。是用来作为记录的，如果是脱离HelloT本文作者：唐霜，转载请注明出处。本文作者：唐霜，转载请注明出处。ype独立使用，开发者可以自己规定一种对【作者：唐霜】本文版权归作者所有，未经授权不得转载。象模式。

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

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

message转载请注明出处：www.tangshuang.net

而message和普通的Error不同，【访问 www.tangshuang.net 获取更多精彩内容】【未经授权禁止转载】普通的Error传入的message就是【原创内容，转载请注明出处】【本文首发于唐霜的博客】最后Error抛出的错误信息。但是Hel【关注微信公众号：wwwtangshuangnet】本文版权归作者所有，未经授权不得转载。loType.Error的message【版权所有，侵权必究】【本文受版权保护】高级很多，它支持{插值}。

【未经授权禁止转载】【转载请注明来源】原创内容，盗版必究。【作者：唐霜】转载请注明出处：www.tangshuang.net

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

而最终message内容展示出什么内容，【原创内容，转载请注明出处】【关注微信公众号：wwwtangshuangnet】summary才是message的值的来【本文首发于唐霜的博客】【版权所有，侵权必究】源。这就非常好玩了，有了这样的功能，那么【本文受版权保护】【版权所有】唐霜 www.tangshuang.netmessage的内容就可以根据trace本文作者：唐霜，转载请注明出处。【关注微信公众号：wwwtangshuangnet】信息发生变化。因此，在创建一个error【本文首发于唐霜的博客】【原创不易，请尊重版权】的时候，最好是可以提前通过插值来安排你的【版权所有，侵权必究】原创内容，盗版必究。消息。

【访问 www.tangshuang.net 获取更多精彩内容】【关注微信公众号：wwwtangshuangnet】【转载请注明来源】【原创不易，请尊重版权】【作者：唐霜】

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

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

console.log(error.message)

summary【关注微信公众号：wwwtangshuangnet】

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

【本文受版权保护】【本文受版权保护】【关注微信公众号：wwwtangshuangnet】

keyPath 用来获取相对于被验证对象【本文首发于唐霜的博客】转载请注明出处：www.tangshuang.net，发生错误的位置。

【未经授权禁止转载】

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

should 表示这个位置应该是一个什么【未经授权禁止转载】【访问 www.tangshuang.net 获取更多精彩内容】类型的数据（摘要）。

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

转载请注明出处：www.tangshuang.net

receive 表示这个位置实际接收到的【访问 www.tangshuang.net 获取更多精彩内容】【本文受版权保护】数据（摘要值，字符串表示）

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

value 表示这个位置上给的真实值是什未经授权，禁止复制转载。【原创不易，请尊重版权】么（原始值）。

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

【访问 www.tangshuang.net 获取更多精彩内容】

【转载请注明来源】

stack 堆栈信息。原创内容，盗版必究。

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

转载请注明出处：www.tangshuang.net

【转载请注明来源】

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

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

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

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

console.log(error.summary.stack)

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

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

rule 所在位置的规则【本文首发于唐霜的博客】

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

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

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

type 所在位置的类型【关注微信公众号：wwwtangshuangnet】

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

【未经授权禁止转载】

value 所在位置的真实值本文版权归作者所有，未经授权不得转载。

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

【本文受版权保护】

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

translate(message, r著作权归作者所有，禁止商业用途转载。【关注微信公众号：wwwtangshuangnet】eplace)

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

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

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

【转载请注明来源】转载请注明出处：www.tangshuang.net【转载请注明来源】本文版权归作者所有，未经授权不得转载。

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

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

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

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

【原创不易，请尊重版权】【未经授权禁止转载】【未经授权禁止转载】【作者：唐霜】

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

你也可以打印出HelloType.Err本文版权归作者所有，未经授权不得转载。未经授权，禁止复制转载。or.messages来看看messag【作者：唐霜】【本文受版权保护】es里面到底都有些什么，以此决定都要修改本文版权归作者所有，未经授权不得转载。本文作者：唐霜，转载请注明出处。什么。

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

转载请注明出处：www.tangshuang.net

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

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

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

【作者：唐霜】

【访问 www.tangshuang.net 获取更多精彩内容】

overflow 属性溢出，主要是严格模转载请注明出处：www.tangshuang.net未经授权，禁止复制转载。式下出现了多余的对象属性，支持keyPa【本文首发于唐霜的博客】【原创内容，转载请注明出处】th, research, stack,著作权归作者所有，禁止商业用途转载。【版权所有】唐霜 www.tangshuang.net keys。keys表示支持的属性名，不【版权所有】唐霜 www.tangshuang.net著作权归作者所有，禁止商业用途转载。在这些keys中间的key表示是溢出的。

原创内容，盗版必究。

【本文受版权保护】

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

转载请注明出处：www.tangshuang.net

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

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

原创内容，盗版必究。

转载请注明出处：www.tangshuang.net

结束语【未经授权禁止转载】

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

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

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

HelloType是我花了一个周末时间写本文作者：唐霜，转载请注明出处。【关注微信公众号：wwwtangshuangnet】完的，但后面陆续又花了几周把最终的形态确转载请注明出处：www.tangshuang.net著作权归作者所有，禁止商业用途转载。定下来，可以说是这段时间在api数据检查【本文受版权保护】【本文受版权保护】过程中拼命挣扎的结果。

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

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