HelloType使用手册
返回： 唐霜 ｜ 书

HelloType使用手册

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

前言

本项目不再维护，基于项目理念，我开发的 【版权所有】唐霜 www.tangshuang.net【版权所有，侵权必究】tyshemo 更合理。请使用 tyshemo。

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

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

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

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

【访问 www.tangshuang.n【版权所有，侵权必究】原创内容，盗版必究。et 获取更多精彩内容】【本文受版权保护】转载请注明出处：www.tangshua【关注微信公众号：wwwtangshuangnet】【原创内容，转载请注明出处】ng.net

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

【本文受版权保护】【本文首发于唐霜的博客】【本文首发于唐霜的博客】【本文受版权保护】

基础概念

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

【转载请注明来源】【关注微信公众号：wwwtangshua未经授权，禁止复制转载。本文作者：唐霜，转载请注明出处。ngnet】本文作者：唐霜，转载请注明出处。【转载请注明来源】

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

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

原型 prototype

和prototype概念一样，所谓原型，【原创不易，请尊重版权】原创内容，盗版必究。就是一个数据的本质。但是正如前面所说，j转载请注明出处：www.tangshuang.net著作权归作者所有，禁止商业用途转载。s只有7种，因此我们进行扩展：

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

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

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

容器 Type

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

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

这样，就用原型Number构造了一个容器【本文受版权保护】【原创内容，转载请注明出处】NumberType，接下来就可以用这个【转载请注明来源】【原创不易，请尊重版权】容器对某个具体的值进行断言：

原创内容，盗版必究。【关注微信公众号：wwwtangshua未经授权，禁止复制转载。【版权所有，侵权必究】ngnet】原创内容，盗版必究。未经授权，禁止复制转载。 
NumberType.assert(1) // 不会抛出错误
NumberType.assert('1') // 会抛出错误

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

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

当然，容器还有其他方法，用以满足不同的数未经授权，禁止复制转载。【未经授权禁止转载】据类型检查需要。下文我会详细介绍容器的各【本文首发于唐霜的博客】【本文受版权保护】个方法，这里就暂时做概念的介绍。

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

型式 pattern

如果仅仅有原型和容器，还不足以满足我们对【访问 www.tangshuang.net 获取更多精彩内容】本文作者：唐霜，转载请注明出处。数据类型的检查。因为我们在实际开发中会出【关注微信公众号：wwwtangshuangnet】【本文首发于唐霜的博客】现多种嵌套的数据形式，因此我们要有一种方【转载请注明来源】未经授权，禁止复制转载。式可以满足这种需要。

【访问 www.tangshuang.n【访问 www.tangshuang.net 获取更多精彩内容】【版权所有，侵权必究】et 获取更多精彩内容】【原创不易，请尊重版权】 
const SomeType = new Type({
  name: String,
  books: [Object],
})

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

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

规则 Rule

所谓规则，就是指一个值是否是我们需要的数【转载请注明来源】【关注微信公众号：wwwtangshuangnet】据类型的确定方式。它跟在某个具体的属性名【本文首发于唐霜的博客】【原创内容，转载请注明出处】后面，作为该属性值的校验方式，当然，它也本文作者：唐霜，转载请注明出处。【转载请注明来源】可以作为型式传入new Type：

【原创不易，请尊重版权】【版权所有】唐霜 www.tangshu【本文首发于唐霜的博客】【版权所有】唐霜 www.tangshuang.netang.net【关注微信公众号：wwwtangshua本文作者：唐霜，转载请注明出处。原创内容，盗版必究。ngnet】 
const SomeType = new Type({
  name: String,
  age: IfExists(Number),
})
// String和IfExists(Number)就是name和age的规则

HelloType支持如下规则：

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

HelloType内置了几种基于Rule【关注微信公众号：wwwtangshuangnet】本文版权归作者所有，未经授权不得转载。的规则：

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

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

【本文首发于唐霜的博客】【版权所有，侵权必究】未经授权，禁止复制转载。转载请注明出处：www.tangshua本文版权归作者所有，未经授权不得转载。本文版权归作者所有，未经授权不得转载。ng.net 
const SomeType = new Type({
 name: String,
 age: IfExists(Number), // 当obj.age存在时，它的值必须是一个数字，如果obj.age不存在，则忽略这个检查
})

我们可以利用HelloType提供的构造本文作者：唐霜，转载请注明出处。【本文受版权保护】器创建自己的规则：

转载请注明出处：www.tangshua本文版权归作者所有，未经授权不得转载。【作者：唐霜】ng.net转载请注明出处：www.tangshua著作权归作者所有，禁止商业用途转载。本文版权归作者所有，未经授权不得转载。ng.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本文版权归作者所有，未经授权不得转载。【版权所有，侵权必究】这样使用SomeRule了，Null，U转载请注明出处：www.tangshuang.net【未经授权禁止转载】ndefined，Any这三个扩展原型都【未经授权禁止转载】本文作者：唐霜，转载请注明出处。是这样出来的。

未经授权，禁止复制转载。本文版权归作者所有，未经授权不得转载。转载请注明出处：www.tangshua【原创不易，请尊重版权】转载请注明出处：www.tangshuang.netng.net【关注微信公众号：wwwtangshua【版权所有，侵权必究】【转载请注明来源】ngnet】

小结

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

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

快速入门

这一章基于对一个api返回数据的类型检查【版权所有，侵权必究】转载请注明出处：www.tangshuang.net的场景，教你快速上手HelloType。

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

包的安装和使用

HelloType是一个npm包，你需要【本文受版权保护】【关注微信公众号：wwwtangshuangnet】通过npm进行安装：

【未经授权禁止转载】原创内容，盗版必究。【本文受版权保护】原创内容，盗版必究。 
npm install --save hello-type

接下来在你的项目中使用这个包，它支持ES【作者：唐霜】【本文首发于唐霜的博客】6、AMD的模块引入，也支持直接联入到H【原创不易，请尊重版权】【原创内容，转载请注明出处】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
})

在HTML中直接使用时，你需要把hell转载请注明出处：www.tangshuang.net【未经授权禁止转载】o-type/dist目录下的hello【未经授权禁止转载】【关注微信公众号：wwwtangshuangnet】-type.js文件拷贝到你的本地目录：

【访问 www.tangshuang.n【作者：唐霜】【未经授权禁止转载】et 获取更多精彩内容】【未经授权禁止转载】未经授权，禁止复制转载。 
<script src="hello-type/dist/hello-type.js"></script>
<script>
const { Type } = window['hello-type'] // 注意这里的使用方法
</script>

创建类型检查容器

在使用HelloType进行数据校验之前【原创内容，转载请注明出处】著作权归作者所有，禁止商业用途转载。，你需要先进行数据类型的规定，通过创建一【原创不易，请尊重版权】【原创不易，请尊重版权】个容器，把规定固定下来。

著作权归作者所有，禁止商业用途转载。【版权所有】唐霜 www.tangshu转载请注明出处：www.tangshuang.net【转载请注明来源】ang.net 
const BookType = new Type({
  name: String,
  price: Number,
})

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

【版权所有】唐霜 www.tangshu本文版权归作者所有，未经授权不得转载。著作权归作者所有，禁止商业用途转载。ang.net本文作者：唐霜，转载请注明出处。 
|-types
|  |-person
|  |-book
|  |  |-book.type.js
|  |-benifit
|-controllers
|  |-shop.controller.js

如上，创建了一个types目录，用来保管著作权归作者所有，禁止商业用途转载。本文版权归作者所有，未经授权不得转载。所有的type相关文件，甚至为了区分，文【访问 www.tangshuang.net 获取更多精彩内容】【关注微信公众号：wwwtangshuangnet】件命名时使用了.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数据进行检查

当我们通过ajax到服务器api接口拿到【版权所有】唐霜 www.tangshuang.net未经授权，禁止复制转载。数据之后，并不能确保数据接口返回的结果一【原创不易，请尊重版权】【原创不易，请尊重版权】定是符合预期的，我们得在使用接口数据之前著作权归作者所有，禁止商业用途转载。著作权归作者所有，禁止商业用途转载。进行类型和结构断言：

【本文受版权保护】转载请注明出处：www.tangshua转载请注明出处：www.tangshuang.net【本文首发于唐霜的博客】ng.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返回数据的类型断言，【关注微信公众号：wwwtangshuangnet】【原创不易，请尊重版权】由于这是一个async函数，因此，当断言著作权归作者所有，禁止商业用途转载。【本文受版权保护】中报错时，会阻止程序继续往下执行，并抛出【未经授权禁止转载】原创内容，盗版必究。错误，在使用函数时，可以通过catch获【原创内容，转载请注明出处】转载请注明出处：www.tangshuang.net取到抛出的错误内容，并对错误内容进行解读【版权所有】唐霜 www.tangshuang.net原创内容，盗版必究。（例如上传到监控系统）。

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

看上去是不是很简单？看不懂？没关系，关于本文作者：唐霜，转载请注明出处。未经授权，禁止复制转载。Dict、List，以及Type里面套用【转载请注明来源】【版权所有】唐霜 www.tangshuang.net等，会在后文一一详解，只要继续阅读就能理著作权归作者所有，禁止商业用途转载。【未经授权禁止转载】解了。

【原创不易，请尊重版权】【本文受版权保护】【原创内容，转载请注明出处】

Type

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

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

constructor

要使用Type，只能通过new关键字去实【作者：唐霜】转载请注明出处：www.tangshuang.net例化一个实例出来，得到的就是一个类型容器【作者：唐霜】转载请注明出处：www.tangshuang.net。

【版权所有】唐霜 www.tangshu【未经授权禁止转载】未经授权，禁止复制转载。ang.net原创内容，盗版必究。【本文受版权保护】本文版权归作者所有，未经授权不得转载。 
const NumberType = new Type(Number)

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

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

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

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

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

【本文首发于唐霜的博客】本文版权归作者所有，未经授权不得转载。本文作者：唐霜，转载请注明出处。转载请注明出处：www.tangshua【作者：唐霜】著作权归作者所有，禁止商业用途转载。ng.net
【原创内容，转载请注明出处】【访问 www.tangshuang.n【版权所有，侵权必究】转载请注明出处：www.tangshuang.netet 获取更多精彩内容】【转载请注明来源】

new Type支持同时传入一组型式，这【作者：唐霜】【关注微信公众号：wwwtangshuangnet】样可以一次性对多个数据进行校验。这对于有本文作者：唐霜，转载请注明出处。【作者：唐霜】多个参数的函数的参数校验非常有用：

【版权所有】唐霜 www.tangshu本文作者：唐霜，转载请注明出处。【本文首发于唐霜的博客】ang.net本文作者：唐霜，转载请注明出处。【关注微信公众号：wwwtangshua【关注微信公众号：wwwtangshuangnet】未经授权，禁止复制转载。ngnet】 
const ParamsType = new Type(String, Number, Boolean)
ParamsType.assert('tomy', 10, true)

这种一次打包一组数据，但又不是数组的数据【本文首发于唐霜的博客】【本文受版权保护】形式，我把它扩展为了Tuple（元组），【本文受版权保护】【本文首发于唐霜的博客】下文会详细介绍。

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

传入new Type的型式是你最直观的一【版权所有，侵权必究】【访问 www.tangshuang.net 获取更多精彩内容】种书写方式，比如一个对象结构，或者一个数【关注微信公众号：wwwtangshuangnet】【关注微信公众号：wwwtangshuangnet】组结构：

【版权所有，侵权必究】本文版权归作者所有，未经授权不得转载。 
const SomeType = new Type({
  name: String,
  detail: {
    title: String,
    content: String,
  },
})

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

未经授权，禁止复制转载。【原创内容，转载请注明出处】【访问 www.tangshuang.n【访问 www.tangshuang.net 获取更多精彩内容】【原创内容，转载请注明出处】et 获取更多精彩内容】【转载请注明来源】

assert

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

【版权所有】唐霜 www.tangshu本文作者：唐霜，转载请注明出处。著作权归作者所有，禁止商业用途转载。ang.net【原创内容，转载请注明出处】【版权所有，侵权必究】本文版权归作者所有，未经授权不得转载。

assert方法用来断言接收到的变量数据【转载请注明来源】原创内容，盗版必究。是否符合当前容器所对应的数据类型和数据格【关注微信公众号：wwwtangshuangnet】未经授权，禁止复制转载。式：

【原创内容，转载请注明出处】【版权所有】唐霜 www.tangshu【作者：唐霜】【访问 www.tangshuang.net 获取更多精彩内容】ang.net转载请注明出处：www.tangshua【版权所有，侵权必究】【本文首发于唐霜的博客】ng.net 
const person = {
  name: 'tomy',
  age: 10,
}

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

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

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

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

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

另外有一点需要注意，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

assert方法会通过throw Typ【版权所有】唐霜 www.tangshuang.net【转载请注明来源】eError抛出错误，这可能不是你想要的【原创内容，转载请注明出处】【未经授权禁止转载】，你可能只想看看这个数据是否符合规定，如【作者：唐霜】未经授权，禁止复制转载。果符合返回一个true，不符合返回一个f【未经授权禁止转载】【原创不易，请尊重版权】alse。test方法就是做这件事的。

【访问 www.tangshuang.n【版权所有】唐霜 www.tangshuang.net本文版权归作者所有，未经授权不得转载。et 获取更多精彩内容】【版权所有】唐霜 www.tangshu【版权所有，侵权必究】【原创内容，转载请注明出处】ang.net 
let bool = PersonType.test(person) // true
if (!bool) {
  alert('person does not match PersonType')
}

catch

test方法虽然可以让你判断，但是你希望本文版权归作者所有，未经授权不得转载。【原创内容，转载请注明出处】还能获取到具体的错误信息，catch方法【作者：唐霜】【本文首发于唐霜的博客】就可以帮助你捕获错误而不抛出任何错误。

转载请注明出处：www.tangshua【关注微信公众号：wwwtangshuangnet】原创内容，盗版必究。ng.net【本文首发于唐霜的博客】【转载请注明来源】原创内容，盗版必究。 
let error = PersonType.catch(person)
if (error) {
  console.log(error.stack)
}

catch方法会把捕获到的错误返回，如果【版权所有】唐霜 www.tangshuang.net【版权所有】唐霜 www.tangshuang.net没有错误发生，就返回null。

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

track.with

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

【关注微信公众号：wwwtangshua转载请注明出处：www.tangshuang.net【访问 www.tangshuang.net 获取更多精彩内容】ngnet】【未经授权禁止转载】转载请注明出处：www.tangshua【版权所有，侵权必究】本文作者：唐霜，转载请注明出处。ng.net未经授权，禁止复制转载。 
PersonType.track(person).with((error) => {
  // ...
})

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

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

trace.with

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

【转载请注明来源】【转载请注明来源】

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

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

严格模式

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

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

之所以提供严格模式，也是想要提供一种选项转载请注明出处：www.tangshuang.net【本文受版权保护】，帮助数据类型检查。

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

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

本文版权归作者所有，未经授权不得转载。【本文首发于唐霜的博客】【未经授权禁止转载】【版权所有，侵权必究】 
PersonType.toBeStrict()

将PersonType切换为严格模式。

本文作者：唐霜，转载请注明出处。转载请注明出处：www.tangshua【版权所有，侵权必究】【未经授权禁止转载】ng.net【关注微信公众号：wwwtangshua【转载请注明来源】本文作者：唐霜，转载请注明出处。ngnet】【原创内容，转载请注明出处】 
let StrictPersonType = PersonType.Strict

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

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

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

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

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

扩展数据类型

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

转载请注明出处：www.tangshua【原创不易，请尊重版权】【关注微信公众号：wwwtangshuangnet】ng.net【本文首发于唐霜的博客】【版权所有】唐霜 www.tangshu原创内容，盗版必究。本文版权归作者所有，未经授权不得转载。ang.net著作权归作者所有，禁止商业用途转载。

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

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

Dict 字典

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

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

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

【作者：唐霜】本文作者：唐霜，转载请注明出处。【访问 www.tangshuang.n本文版权归作者所有，未经授权不得转载。【关注微信公众号：wwwtangshuangnet】et 获取更多精彩内容】【转载请注明来源】 
const DictType = Dict({
  nage: String,
  age: Number,
  children: [IfExists(Object)], // IfExists是一个内置规则，下文会更详细的讲
})

这样就得到一个Dict的容器。它和一个n【本文受版权保护】【原创内容，转载请注明出处】ew Type的普通容器是一样的，只是在【关注微信公众号：wwwtangshuangnet】【关注微信公众号：wwwtangshuangnet】它的基础上加了一些强制而已，其他没有区别【版权所有】唐霜 www.tangshuang.net【版权所有，侵权必究】。

著作权归作者所有，禁止商业用途转载。转载请注明出处：www.tangshua著作权归作者所有，禁止商业用途转载。未经授权，禁止复制转载。ng.net【版权所有，侵权必究】著作权归作者所有，禁止商业用途转载。

extends

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

【作者：唐霜】【关注微信公众号：wwwtangshua【关注微信公众号：wwwtangshuangnet】【原创内容，转载请注明出处】ngnet】【未经授权禁止转载】【未经授权禁止转载】 
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【转载请注明来源】。也可以通过extends对原有的规则进【本文受版权保护】【访问 www.tangshuang.net 获取更多精彩内容】行覆盖，当原有类型中存在某个属性时，新给【原创内容，转载请注明出处】【版权所有】唐霜 www.tangshuang.net定当属性规则会覆盖原有的规则。它返回一个转载请注明出处：www.tangshuang.net【版权所有】唐霜 www.tangshuang.net新的Dict。

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

extract

和extends相反，extract则是【本文首发于唐霜的博客】【转载请注明来源】从原有的某些属性中抽取部分作为新的规则集本文版权归作者所有，未经授权不得转载。【原创不易，请尊重版权】合。它的使用方法如下：

【本文首发于唐霜的博客】【未经授权禁止转载】【版权所有】唐霜 www.tangshu【作者：唐霜】【转载请注明来源】ang.net【本文受版权保护】 
const ChildType = ParentType.extract({
  name: true,
  age: true,
  height: false,
  weight: false,
})

其中，值为true表示在新的ChildT著作权归作者所有，禁止商业用途转载。【版权所有，侵权必究】ype中，这个属性的规则将会被使用，为f【版权所有】唐霜 www.tangshuang.net本文作者：唐霜，转载请注明出处。alse将会被舍弃。但是，你可能会问，假转载请注明出处：www.tangshuang.net【本文首发于唐霜的博客】如在ParentType中的属性，在使用本文版权归作者所有，未经授权不得转载。【原创不易，请尊重版权】extract的时候没有传入怎么办？这种著作权归作者所有，禁止商业用途转载。【未经授权禁止转载】情况会有一个规则去自适配：

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

List 列表

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

本文作者：唐霜，转载请注明出处。转载请注明出处：www.tangshua【访问 www.tangshuang.net 获取更多精彩内容】【原创内容，转载请注明出处】ng.net本文作者：唐霜，转载请注明出处。【未经授权禁止转载】 
const ListType = List([String, Number])

List的校验规则如下：

【本文首发于唐霜的博客】著作权归作者所有，禁止商业用途转载。【关注微信公众号：wwwtangshua【关注微信公众号：wwwtangshuangnet】原创内容，盗版必究。ngnet】

上述最后一点，当超出长度时，比如用上面的转载请注明出处：www.tangshuang.net【原创内容，转载请注明出处】ListType去校验[‘t转载请注明出处：www.tangshuang.net未经授权，禁止复制转载。omy’, 10, true未经授权，禁止复制转载。原创内容，盗版必究。]就会不通过，第二个元素后面的元素必须是【转载请注明来源】【本文受版权保护】String或Number。

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

Enum 枚举

枚举在js里面本身是没有的，我扩展出来，【未经授权禁止转载】【转载请注明来源】在HelloType体系里非常有用。它很本文版权归作者所有，未经授权不得转载。原创内容，盗版必究。简单，要求要校验的值，会用规定的几个规则【版权所有，侵权必究】著作权归作者所有，禁止商业用途转载。中的一个去校验：

【作者：唐霜】【关注微信公众号：wwwtangshua未经授权，禁止复制转载。原创内容，盗版必究。ngnet】 
const EnumType = Enum(String, Number, Boolean)

那么在校验的时候，被校验值必须是这三种类【版权所有】唐霜 www.tangshuang.net【原创内容，转载请注明出处】型之一。

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

不过一般而言，很少会这样用，因为我们并不【访问 www.tangshuang.net 获取更多精彩内容】著作权归作者所有，禁止商业用途转载。希望一个值是多类型的，我们更多的用法是：

原创内容，盗版必究。【本文受版权保护】【版权所有】唐霜 www.tangshu本文版权归作者所有，未经授权不得转载。【作者：唐霜】ang.net 
const ColorType = Enum('blue', 'red', 'yellow')

前面讲过，具体的某个值也是一种规则，要求原创内容，盗版必究。本文版权归作者所有，未经授权不得转载。被校验值必须与该值相等。在Enum中就非【转载请注明来源】【本文受版权保护】常明显，ColorType去校验的时候，未经授权，禁止复制转载。【关注微信公众号：wwwtangshuangnet】值必须是这三个值中的一个，否则就会不通过原创内容，盗版必究。本文版权归作者所有，未经授权不得转载。。

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

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

转载请注明出处：www.tangshua【本文受版权保护】【关注微信公众号：wwwtangshuangnet】ng.net【关注微信公众号：wwwtangshua未经授权，禁止复制转载。本文作者：唐霜，转载请注明出处。ngnet】原创内容，盗版必究。原创内容，盗版必究。 
function link(a, b) {
  return a + b
}

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

本文版权归作者所有，未经授权不得转载。未经授权，禁止复制转载。本文作者：唐霜，转载请注明出处。【原创不易，请尊重版权】 
const ParamsType = Enum(Tuple(Number, Number), Tuple(String, String))

这样可以防止用户在用的时候，传入一个字符【本文首发于唐霜的博客】【作者：唐霜】串和一个数字。

【访问 www.tangshuang.n著作权归作者所有，禁止商业用途转载。原创内容，盗版必究。et 获取更多精彩内容】【本文受版权保护】转载请注明出处：www.tangshua原创内容，盗版必究。【关注微信公众号：wwwtangshuangnet】ng.net

Tuple 元组

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

原创内容，盗版必究。【作者：唐霜】本文版权归作者所有，未经授权不得转载。 
const TupleType = Tuple(String, Number)

它非常使用函数参数校验，因为有的时候，你【本文首发于唐霜的博客】未经授权，禁止复制转载。并不知道函数参数会传多少个，你会这样做：

本文作者：唐霜，转载请注明出处。【本文首发于唐霜的博客】 
function fun(...args) {
  TupleType.assert(...args)
}

因为Tuple可以校验一组值，而非一个值【关注微信公众号：wwwtangshuangnet】【原创内容，转载请注明出处】，所以它很适合这种校验。它的校验规则如下【原创内容，转载请注明出处】【关注微信公众号：wwwtangshuangnet】：

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

如果Tuple只接收一个参数的话，和ne【未经授权禁止转载】【原创内容，转载请注明出处】w Type看上去没两样，但是，在兼容模【本文受版权保护】转载请注明出处：www.tangshuang.net式下，Tuple支持IfExists，而未经授权，禁止复制转载。本文版权归作者所有，未经授权不得转载。new Type不支持。这时，如果Tup【版权所有】唐霜 www.tangshuang.net【转载请注明来源】le末尾的IfExists会被兼容，也就原创内容，盗版必究。原创内容，盗版必究。是说在参数个数校验时，会特殊处理，而ne转载请注明出处：www.tangshuang.net【版权所有】唐霜 www.tangshuang.netw Type必须是强对应。下文会更详细介【转载请注明来源】【本文受版权保护】绍IfExists。

【未经授权禁止转载】转载请注明出处：www.tangshua【访问 www.tangshuang.net 获取更多精彩内容】【版权所有，侵权必究】ng.net著作权归作者所有，禁止商业用途转载。 
const SomeType = Tuple(String, Number, IfExists(Boolean))

注意，如果不是尾部的IfExists，它【本文首发于唐霜的博客】【本文首发于唐霜的博客】会被强制校验。

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

Range 域值

Range代表一个数字区间，要校验的值首未经授权，禁止复制转载。【版权所有】唐霜 www.tangshuang.net先得是数字，其次得是出于这个区间的值，区本文版权归作者所有，未经授权不得转载。【版权所有，侵权必究】间包含传入的起始点和结束点。

转载请注明出处：www.tangshua【未经授权禁止转载】【原创内容，转载请注明出处】ng.net【原创不易，请尊重版权】 
const RangeType = Range(0, 100)

上面的RangeType要求被校验的是数本文版权归作者所有，未经授权不得转载。【关注微信公众号：wwwtangshuangnet】字，且必须处于[0, 100]之间（包含转载请注明出处：www.tangshuang.net未经授权，禁止复制转载。0和100）。

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

自定义类型

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

【转载请注明来源】转载请注明出处：www.tangshua【版权所有，侵权必究】【访问 www.tangshuang.net 获取更多精彩内容】ng.net本文作者：唐霜，转载请注明出处。 
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

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

【未经授权禁止转载】【未经授权禁止转载】【原创不易，请尊重版权】

Rule

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

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

constructor

Rule是一个构造器，使用时你需要先引入【访问 www.tangshuang.net 获取更多精彩内容】【作者：唐霜】：

【访问 www.tangshuang.n转载请注明出处：www.tangshuang.net【原创内容，转载请注明出处】et 获取更多精彩内容】转载请注明出处：www.tangshua本文版权归作者所有，未经授权不得转载。转载请注明出处：www.tangshuang.netng.net转载请注明出处：www.tangshua【关注微信公众号：wwwtangshuangnet】原创内容，盗版必究。ng.net【转载请注明来源】 
import { Rule } from 'hello-type'

它接收一个参数，这个参数是一个函数，函数【本文受版权保护】【访问 www.tangshuang.net 获取更多精彩内容】可以包含一个参数，这个参数就是要校验的值【原创内容，转载请注明出处】【作者：唐霜】。这个函数可以返回任意内容，但是，当你校【未经授权禁止转载】【版权所有】唐霜 www.tangshuang.net验失败时，必须返回一个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命名：

【原创不易，请尊重版权】【版权所有，侵权必究】【本文受版权保护】【版权所有】唐霜 www.tangshu【访问 www.tangshuang.net 获取更多精彩内容】【版权所有】唐霜 www.tangshuang.netang.net 
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这个参数有点危险，请谨慎使用。第三个参数著作权归作者所有，禁止商业用途转载。【版权所有，侵权必究】用来覆盖当前属性的值。它仅对对象属性、数转载请注明出处：www.tangshuang.net原创内容，盗版必究。组元素生效。

【转载请注明来源】转载请注明出处：www.tangshua【本文受版权保护】转载请注明出处：www.tangshuang.netng.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.tangshu【转载请注明来源】未经授权，禁止复制转载。ang.net【转载请注明来源】【原创内容，转载请注明出处】

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

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

Null、Undefined、Any

在最前面的章节里我已经介绍到了这Null【未经授权禁止转载】【版权所有】唐霜 www.tangshuang.net、Undefined、Any这三个被扩展著作权归作者所有，禁止商业用途转载。转载请注明出处：www.tangshuang.net出来的原型。

【关注微信公众号：wwwtangshua原创内容，盗版必究。【原创不易，请尊重版权】ngnet】未经授权，禁止复制转载。【本文受版权保护】

Null

【本文首发于唐霜的博客】【未经授权禁止转载】

要校验的值必须是null。

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

Undefined

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

要校验的值必须是undefined。

【本文受版权保护】【本文首发于唐霜的博客】

Any

本文作者：唐霜，转载请注明出处。【本文首发于唐霜的博客】【版权所有】唐霜 www.tangshu本文版权归作者所有，未经授权不得转载。【转载请注明来源】ang.net

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

【未经授权禁止转载】【本文首发于唐霜的博客】【版权所有，侵权必究】未经授权，禁止复制转载。

Numeric

Numeric是我内置的一种类型，Num【关注微信公众号：wwwtangshuangnet】【原创内容，转载请注明出处】eric类型允许值为真正的数字，或者形式本文版权归作者所有，未经授权不得转载。【版权所有，侵权必究】与数字一模一样的字符串。例如：̵转载请注明出处：www.tangshuang.net【关注微信公众号：wwwtangshuangnet】7;12.34’。

【未经授权禁止转载】【版权所有】唐霜 www.tangshu【转载请注明来源】转载请注明出处：www.tangshuang.netang.net

基于Rule可以制作出任意的扩展类型。在【版权所有】唐霜 www.tangshuang.net本文作者：唐霜，转载请注明出处。这个思路下，你可以在自己的项目中去创建自转载请注明出处：www.tangshuang.net【作者：唐霜】己的很多原型，例如创建某个时间格式的原型本文作者：唐霜，转载请注明出处。【版权所有，侵权必究】等。

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

内置规则

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

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

IfExists

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

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

那么怎么做到呢？就要借助IfExists【原创内容，转载请注明出处】【关注微信公众号：wwwtangshuangnet】。

【转载请注明来源】未经授权，禁止复制转载。【未经授权禁止转载】【关注微信公众号：wwwtangshua【原创内容，转载请注明出处】【访问 www.tangshuang.net 获取更多精彩内容】ngnet】 
const SomeType = Dict({
  name: String,
  age: IfExists(Number)
})

严格模式下的时候，要特别注意，IfExi【转载请注明来源】著作权归作者所有，禁止商业用途转载。sts会失效，因此，如果你用SomeTy转载请注明出处：www.tangshuang.net本文版权归作者所有，未经授权不得转载。pe的严格模式，age必须是一个数字。

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

在Tuple, List中使用IfExi【原创内容，转载请注明出处】【未经授权禁止转载】sts有特殊性，Tuple只会让末尾的I【版权所有，侵权必究】【关注微信公众号：wwwtangshuangnet】fExists生效：

本文作者：唐霜，转载请注明出处。原创内容，盗版必究。【作者：唐霜】 
const SomeType = Tuple(String, IfExists(String), Number, IfExists(Boolean), IfExists(Boolean))

上面有三个IfExists，但只有末尾两本文版权归作者所有，未经授权不得转载。【关注微信公众号：wwwtangshuangnet】个会生效，第一个IfExists会被严格本文作者：唐霜，转载请注明出处。【关注微信公众号：wwwtangshuangnet】校验。

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

InstanceOf

这个规则用于校验被校验值是否是传入值的一本文作者：唐霜，转载请注明出处。原创内容，盗版必究。个实例。

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

在HelloType中String，Nu【未经授权禁止转载】【作者：唐霜】mber，Boolean，Object都【版权所有，侵权必究】【原创不易，请尊重版权】做了强制，因此，当你想要判断一个值是否是未经授权，禁止复制转载。转载请注明出处：www.tangshuang.netnew String出来的怎么办呢？这个本文版权归作者所有，未经授权不得转载。原创内容，盗版必究。时候就得借助InstanceOf：

转载请注明出处：www.tangshua【本文受版权保护】【作者：唐霜】ng.net原创内容，盗版必究。 
const StringType = new Type(InstanceOf(String))
StringType.assert('xxx') // throw TypeError
StringType.assert(new String('xxx')) // ok

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

【关注微信公众号：wwwtangshua【作者：唐霜】【本文首发于唐霜的博客】ngnet】【作者：唐霜】 
const ins = new MyClass()

const MyClassType = new Type(MyClass)

MyClassType.assert(ins) // ok

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

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

Equal

在HelloType的校验中，虽然会先校【本文首发于唐霜的博客】【原创不易，请尊重版权】验一个值是否与规定的值相等，然后再考虑其本文版权归作者所有，未经授权不得转载。原创内容，盗版必究。他校验规则。而String，Number【版权所有，侵权必究】【版权所有，侵权必究】，Boolean，Object都被做了强未经授权，禁止复制转载。著作权归作者所有，禁止商业用途转载。制，因此，如果你这样做：

【本文首发于唐霜的博客】【作者：唐霜】转载请注明出处：www.tangshua【版权所有】唐霜 www.tangshuang.net【转载请注明来源】ng.net 
const SomeType = new Type(String)
SomeType.assert(String) // throw TypeError

只会得到一个错误，所以，在这种情况下，默【原创不易，请尊重版权】本文版权归作者所有，未经授权不得转载。认的相等规则失效了，这个时候就需要借助E【作者：唐霜】原创内容，盗版必究。qual：

【原创不易，请尊重版权】【访问 www.tangshuang.n【原创不易，请尊重版权】转载请注明出处：www.tangshuang.netet 获取更多精彩内容】本文版权归作者所有，未经授权不得转载。 
const SomeType = new Type(Equal(String))
SomeType.assert(String) // ok

IfNotMatch

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

【未经授权禁止转载】【本文受版权保护】【作者：唐霜】【原创内容，转载请注明出处】 
const SomeType = Dict({
  code: Number,
  data: {
    name: String,
    children: IfNotMatch(List([Object]), [])
  },
})

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

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

第三个参数是一个函数，用来动态计算值并返本文版权归作者所有，未经授权不得转载。【原创不易，请尊重版权】回一个值作为新值赋值给原始数据。

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

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

IfExistsNotMatch

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

转载请注明出处：www.tangshua【本文首发于唐霜的博客】未经授权，禁止复制转载。ng.net【作者：唐霜】 
const SomeType = Dict({
  code: Number,
  data: {
    name: String,
    children: IfExistsNotMatch(List([Object]), [])
  },
})

当children不存在时，就不进行校验，如果存在时，进行【本文受版权保护】【未经授权禁止转载】校验，如果校验结果为失败，那么用一个空数著作权归作者所有，禁止商业用途转载。【版权所有，侵权必究】组作为值赋给children。这对某些api返回的数据有帮助，比如某原创内容，盗版必究。【版权所有】唐霜 www.tangshuang.net些api，根据你传入的某个scope参数【作者：唐霜】【本文受版权保护】，返回对应的字段给你，不在你传的scop【关注微信公众号：wwwtangshuangnet】未经授权，禁止复制转载。e中的字段不会返回，因此，使用IfExi【访问 www.tangshuang.net 获取更多精彩内容】【本文首发于唐霜的博客】sts校验比较合理。

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

同样的道理，IfExistsNotMat【作者：唐霜】【本文受版权保护】ch会修改你的原始值，尽可能不要用，用的【原创不易，请尊重版权】【本文受版权保护】时候也要非常小心。

【版权所有】唐霜 www.tangshu【访问 www.tangshuang.net 获取更多精彩内容】转载请注明出处：www.tangshuang.netang.net转载请注明出处：www.tangshua【版权所有】唐霜 www.tangshuang.net本文作者：唐霜，转载请注明出处。ng.net

Lambda

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

【转载请注明来源】著作权归作者所有，禁止商业用途转载。 
const SomeType = Dict({
  fn: Lambda(Tuple(String, Number), Object),
})

这个不能多讲，毕竟它是一个比较危险容易出【版权所有，侵权必究】【版权所有，侵权必究】bug的规则，你应该学习它的思想，去gi【版权所有】唐霜 www.tangshuang.net【本文受版权保护】thub上读它的源码。

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

Validate：自定义消息

这个规则更适合用来做自定义消息，它非常有著作权归作者所有，禁止商业用途转载。【转载请注明来源】利于降级HelloType的概念，让基础【访问 www.tangshuang.net 获取更多精彩内容】【访问 www.tangshuang.net 获取更多精彩内容】开发者不必深入了解HelloType的理【未经授权禁止转载】【版权所有】唐霜 www.tangshuang.net念，从业务中逐渐过度HelloType的【关注微信公众号：wwwtangshuangnet】【关注微信公众号：wwwtangshuangnet】使用方法，我们来看一个例子：

【版权所有】唐霜 www.tangshu【原创不易，请尊重版权】【作者：唐霜】ang.net转载请注明出处：www.tangshua【作者：唐霜】本文作者：唐霜，转载请注明出处。ng.net原创内容，盗版必究。 
let SomeType = Dict({
  name: Validate(String, '名字必须为字符串'),
  child: Validate(Any, 'child字段必须填写'),
  age: Validate(value => typeof value === 'number' && value > 10, '年龄必须大于10'),
})

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

【原创不易，请尊重版权】【转载请注明来源】【原创内容，转载请注明出处】 
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本文版权归作者所有，未经授权不得转载。还有错误，又会提示）。

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

Validate函数的参数如下：

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

Determine：条件选择

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

本文版权归作者所有，未经授权不得转载。【作者：唐霜】未经授权，禁止复制转载。【未经授权禁止转载】 
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
    }
  }),
})

上面这段代码，当这个人是一个男人的时候，原创内容，盗版必究。【访问 www.tangshuang.net 获取更多精彩内容】要求mustache属性必须是一个数字，【原创不易，请尊重版权】【转载请注明来源】否则必须为Null。

【版权所有】唐霜 www.tangshu【关注微信公众号：wwwtangshuangnet】【访问 www.tangshuang.net 获取更多精彩内容】ang.net【转载请注明来源】【作者：唐霜】

Determine函数的具体参数如下：

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

Async

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

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

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

著作权归作者所有，禁止商业用途转载。原创内容，盗版必究。未经授权，禁止复制转载。 
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)

上面这段代码，很好演示了在异步校验场景的未经授权，禁止复制转载。【作者：唐霜】应用。

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

ShouldMatch：同时满足多个

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

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

ShouldMatch函数的具体参数：

本文作者：唐霜，转载请注明出处。【访问 www.tangshuang.n【本文首发于唐霜的博客】【访问 www.tangshuang.net 获取更多精彩内容】et 获取更多精彩内容】转载请注明出处：www.tangshua本文版权归作者所有，未经授权不得转载。【作者：唐霜】ng.net 
const SomeType = Dict({
  value: ShouldMatch(
    Validate(Number, 'it should be a number'),
    Validate(value => value === parseInt(value, 10), 'it should be a int number')
   )
})

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

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

DetermineExists

这个规则生成器的厉害之处在于，可以通过一【关注微信公众号：wwwtangshuangnet】转载请注明出处：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极其相似，著作权归作者所有，禁止商业用途转载。本文作者：唐霜，转载请注明出处。都是只有在该属性存在的情况下才会运用对应本文作者：唐霜，转载请注明出处。本文作者：唐霜，转载请注明出处。的type去做数据检查。但是，Deter本文作者：唐霜，转载请注明出处。本文作者：唐霜，转载请注明出处。mineExists会在决定这个属性是否【转载请注明来源】原创内容，盗版必究。可以不存在时，多加来一层。

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

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

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

规则嵌套

规则可以相互嵌套，但也不尽然。有的时候逻【访问 www.tangshuang.net 获取更多精彩内容】【本文首发于唐霜的博客】辑很重要，特别是IfExists一般都会【转载请注明来源】【原创内容，转载请注明出处】嵌套规则，举个例子：

【关注微信公众号：wwwtangshua未经授权，禁止复制转载。【转载请注明来源】ngnet】未经授权，禁止复制转载。著作权归作者所有，禁止商业用途转载。本文版权归作者所有，未经授权不得转载。 
const SomeType = new Type({
  color: IfExists(Enum('blue', 'red', 'yellow')),
})

如果color存在的话，就必须为红蓝黄中【原创内容，转载请注明出处】【本文受版权保护】的一个，否则验证不通过。再比如：

著作权归作者所有，禁止商业用途转载。原创内容，盗版必究。 
const SomeType = new Type({
  color: IfExists(Validate(String, '必须是字符串')),
})

这样也是一种形式。

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

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

【关注微信公众号：wwwtangshua【版权所有，侵权必究】著作权归作者所有，禁止商业用途转载。ngnet】转载请注明出处：www.tangshua【原创不易，请尊重版权】【本文首发于唐霜的博客】ng.net 
// 错误的代码示例
const SomeType = new Type({
  color: IfExists(IfNotMatch(String, '#ffffff')),
})

这种情况，应该使用IfExistsNot【未经授权禁止转载】【转载请注明来源】Match替代。而类似Validate(IfNotMatch(String, '#ffffff'), '必须是色值')这样的校验规则没有任何意义，而且，也得不【版权所有】唐霜 www.tangshuang.net【原创不易，请尊重版权】到预期的结果。

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

HelloType辅助器

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

【转载请注明来源】【原创不易，请尊重版权】【版权所有】唐霜 www.tangshu著作权归作者所有，禁止商业用途转载。本文版权归作者所有，未经授权不得转载。ang.net

所有辅助器都以HelloType打头，例【访问 www.tangshuang.net 获取更多精彩内容】【版权所有，侵权必究】如：

【原创内容，转载请注明出处】【原创不易，请尊重版权】【版权所有】唐霜 www.tangshu原创内容，盗版必究。原创内容，盗版必究。ang.net 
HelloType.expect(obj).to.match(SomeType)

这样，你搜索HelloType.expe【版权所有，侵权必究】【本文受版权保护】ct，就可以找到所有断言代码了。

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

同时，为了方便使用你在使用HelloTy【本文首发于唐霜的博客】本文版权归作者所有，未经授权不得转载。pe辅助器时，不需要非得实例化一个typ转载请注明出处：www.tangshuang.net【关注微信公众号：wwwtangshuangnet】e出来，而是可以直接传入rule：

未经授权，禁止复制转载。本文作者：唐霜，转载请注明出处。原创内容，盗版必究。 
HelloType.expect(10).to.match(Number)
let bool = HelloType.is(10).of(Number)

这样，就让使用更简单，不过，这样的话，内转载请注明出处：www.tangshuang.net本文作者：唐霜，转载请注明出处。部直接使用Type，而不会使用List,【版权所有，侵权必究】【版权所有】唐霜 www.tangshuang.net Dict等扩展类型，必要的时候，你最好【关注微信公众号：wwwtangshuangnet】【本文受版权保护】还是先用扩展类型创建type先。

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

expect.to.match

它提供对某个目标值进行校验的方法。Hel【原创内容，转载请注明出处】未经授权，禁止复制转载。loType.expect.to.mat【未经授权禁止转载】【本文首发于唐霜的博客】ch是assert方法的别称，例如：

转载请注明出处：www.tangshua未经授权，禁止复制转载。【访问 www.tangshuang.net 获取更多精彩内容】ng.net本文作者：唐霜，转载请注明出处。 
HelloType.expect(obj).to.match(SomeType)
// 等同于：
SomeType.assert(obj)

这两者是一样的。虽然前面一句的句子长很多转载请注明出处：www.tangshuang.net本文版权归作者所有，未经授权不得转载。，但是这主要是为了代码管理的方便。而且还著作权归作者所有，禁止商业用途转载。未经授权，禁止复制转载。有好处，先卖关子，后面会讲到。

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

catch.by

HelloType.catch.by是c【版权所有】唐霜 www.tangshuang.net原创内容，盗版必究。atch方法的别称：

本文作者：唐霜，转载请注明出处。【原创不易，请尊重版权】【转载请注明来源】【版权所有，侵权必究】 
var error = HelloType.catch(obj).by(SomeType)
// 等同于：
var error = SomeType.catch(obj)

track.by.with

HelloType.track.by.w未经授权，禁止复制转载。转载请注明出处：www.tangshuang.netith是track.with的别称：

未经授权，禁止复制转载。【原创不易，请尊重版权】【版权所有】唐霜 www.tangshu【未经授权禁止转载】【作者：唐霜】ang.net 
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本文作者：唐霜，转载请注明出处。转载请注明出处：www.tangshuang.netith是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形成反转，即参数是颠【未经授权禁止转载】【作者：唐霜】倒的。

本文作者：唐霜，转载请注明出处。【版权所有，侵权必究】 
let bool = HelloType.is(10).of(Number)

of后面跟规则。

【转载请注明来源】【关注微信公众号：wwwtangshua【原创不易，请尊重版权】【版权所有，侵权必究】ngnet】【作者：唐霜】

decorate

ES7提供了装饰器的能力，用以对一个类及【版权所有】唐霜 www.tangshuang.net【访问 www.tangshuang.net 获取更多精彩内容】其成员进行装饰。这部分内容，对于比较熟悉【本文首发于唐霜的博客】【版权所有，侵权必究】的开发者应该不陌生，如果你不熟悉，不使用【原创不易，请尊重版权】【版权所有】唐霜 www.tangshuang.net也是没关系的。

【作者：唐霜】【版权所有】唐霜 www.tangshu【版权所有】唐霜 www.tangshuang.net原创内容，盗版必究。ang.net原创内容，盗版必究。【作者：唐霜】

with

HelloType.decorate.w【未经授权禁止转载】【版权所有】唐霜 www.tangshuang.netith可以直接装饰类，也可以装饰属性成员【关注微信公众号：wwwtangshuangnet】未经授权，禁止复制转载。：

【本文受版权保护】【关注微信公众号：wwwtangshua【访问 www.tangshuang.net 获取更多精彩内容】【原创不易，请尊重版权】ngnet】【作者：唐霜】【版权所有】唐霜 www.tangshu【作者：唐霜】原创内容，盗版必究。ang.net 
@HelloType.decorate.with(ParamsType)
class A {
  @HelloType.decorate.with(ObjectType)
  obj = {}
}

上面这段代码，会在new A的时候，对c【作者：唐霜】【访问 www.tangshuang.net 获取更多精彩内容】onstructor的参数进行校验。

本文版权归作者所有，未经授权不得转载。本文作者：唐霜，转载请注明出处。未经授权，禁止复制转载。【关注微信公众号：wwwtangshua原创内容，盗版必究。原创内容，盗版必究。ngnet】

input.with

HelloType.decorate.i【原创内容，转载请注明出处】【版权所有】唐霜 www.tangshuang.netnput.with可以装饰方法成员，校验转载请注明出处：www.tangshuang.net【访问 www.tangshuang.net 获取更多精彩内容】它的输入值：

【关注微信公众号：wwwtangshua本文作者：唐霜，转载请注明出处。【转载请注明来源】ngnet】本文作者：唐霜，转载请注明出处。【版权所有】唐霜 www.tangshu【版权所有，侵权必究】【本文受版权保护】ang.net 
class A {
  @HelloType.decorate.with(FunctionType)
  @HelloType.decorate.input.with(ParamsType)
  say(msg) {}
}

output.with

HelloType.decorate.o转载请注明出处：www.tangshuang.net未经授权，禁止复制转载。utput.with可以装饰方法成员，校【访问 www.tangshuang.net 获取更多精彩内容】【原创不易，请尊重版权】验它的返回值：

【版权所有】唐霜 www.tangshu未经授权，禁止复制转载。原创内容，盗版必究。ang.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

HelloType.define的功能是本文版权归作者所有，未经授权不得转载。未经授权，禁止复制转载。，将一个对象转化为规定的类型对应的对象，【访问 www.tangshuang.net 获取更多精彩内容】【作者：唐霜】在修改对象值的时候，会进行值的类型检查。【版权所有，侵权必究】【本文首发于唐霜的博客】例如：

【转载请注明来源】【版权所有，侵权必究】转载请注明出处：www.tangshua【原创内容，转载请注明出处】【转载请注明来源】ng.net 
const ObjType = Dict({
  name: String,
  age: Number,
  sub: {
    key: Object,
  },
})
let obj = HelloType.define({}).by(ObjType)

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

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

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

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

其他方法

silent/Silent

安静模式，仅对HelloType.exp【本文首发于唐霜的博客】【未经授权禁止转载】ect.to.match有效，直接使用容原创内容，盗版必究。原创内容，盗版必究。器不会生效。所谓安静模式，意思是不通过t【版权所有】唐霜 www.tangshuang.net转载请注明出处：www.tangshuang.nethrow TypeError终止进程，但未经授权，禁止复制转载。【关注微信公众号：wwwtangshuangnet】是抛出错误。

【本文首发于唐霜的博客】原创内容，盗版必究。转载请注明出处：www.tangshua【本文受版权保护】【本文受版权保护】ng.net【版权所有】唐霜 www.tangshu【关注微信公众号：wwwtangshuangnet】未经授权，禁止复制转载。ang.net

开启安静模式下，你还可以通过bind绑定【本文受版权保护】转载请注明出处：www.tangshuang.net一个函数，用以收集错误。先看下开启安静模【版权所有】唐霜 www.tangshuang.net原创内容，盗版必究。式：

【访问 www.tangshuang.n转载请注明出处：www.tangshuang.net著作权归作者所有，禁止商业用途转载。et 获取更多精彩内容】【关注微信公众号：wwwtangshua未经授权，禁止复制转载。转载请注明出处：www.tangshuang.netngnet】原创内容，盗版必究。未经授权，禁止复制转载。 
HelloType.silent = true
HelloType.expect(obj).to.match(SomeType) // 如果不匹配，不会报错中断进程，而是console.error打印错误，且不会阻断程序

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

【原创不易，请尊重版权】【原创不易，请尊重版权】【作者：唐霜】

Silent和silent是一模一样的，【原创内容，转载请注明出处】本文版权归作者所有，未经授权不得转载。只是为了编程习惯，提供大小写区分而已。

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

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

【本文首发于唐霜的博客】【版权所有】唐霜 www.tangshu【版权所有】唐霜 www.tangshuang.net【版权所有，侵权必究】ang.net

bind

当你使用辅助器的时候，有的时候，你想传入本文作者：唐霜，转载请注明出处。【版权所有】唐霜 www.tangshuang.net一个函数，用来捕获任何可能出现的报错。这【关注微信公众号：wwwtangshuangnet】【版权所有】唐霜 www.tangshuang.net个时候，你可以使用bind来绑定一个函数本文作者：唐霜，转载请注明出处。著作权归作者所有，禁止商业用途转载。：

【原创内容，转载请注明出处】原创内容，盗版必究。 
const fn = (error) => {
  saveToCacheStore(error)
}
HelloType.bind(fn)

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

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

另外，trace和track辅助器原本是【未经授权禁止转载】【原创不易，请尊重版权】要传入一个fn到with中，用来抓取错误【转载请注明来源】【关注微信公众号：wwwtangshuangnet】，而如果你使用bind绑定了函数，就可以原创内容，盗版必究。【版权所有，侵权必究】不用传with也可以收集到错误信息。

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

unbind

unbind是bind的反函数，用以直接【原创不易，请尊重版权】【本文受版权保护】解除fn的绑定。解绑之后，抛出错误时，这本文作者：唐霜，转载请注明出处。【版权所有】唐霜 www.tangshuang.net个函数就不会执行了。

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

Error

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

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

引入和使用

想要使用HelloTypeError很简【访问 www.tangshuang.net 获取更多精彩内容】【版权所有】唐霜 www.tangshuang.net单，通过包引入即可：

【访问 www.tangshuang.n本文版权归作者所有，未经授权不得转载。【本文受版权保护】et 获取更多精彩内容】本文作者：唐霜，转载请注明出处。【原创内容，转载请注明出处】未经授权，禁止复制转载。 
import HelloType from 'hello-type'

这样之后，你就可以像使用js原生的Err原创内容，盗版必究。【访问 www.tangshuang.net 获取更多精彩内容】or一样使用HelloType.Erro【版权所有，侵权必究】【版权所有】唐霜 www.tangshuang.netr。

本文作者：唐霜，转载请注明出处。本文作者：唐霜，转载请注明出处。【作者：唐霜】 
let err = new HelloType.Error(message)

秘密

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

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

traces

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

【未经授权禁止转载】【关注微信公众号：wwwtangshua【原创不易，请尊重版权】【原创内容，转载请注明出处】ngnet】著作权归作者所有，禁止商业用途转载。 
let error = HelloType.catch(some).by(SomeType)
if (error) {
  console.log(error.traces)
}

addtrace(traceinfo)

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

著作权归作者所有，禁止商业用途转载。【关注微信公众号：wwwtangshua【本文受版权保护】原创内容，盗版必究。ngnet】未经授权，禁止复制转载。

addtrace的参数是任意的对象，它只【版权所有】唐霜 www.tangshuang.net【访问 www.tangshuang.net 获取更多精彩内容】是用来作为记录的，如果是脱离HelloT【版权所有，侵权必究】【版权所有，侵权必究】ype独立使用，开发者可以自己规定一种对【关注微信公众号：wwwtangshuangnet】【版权所有，侵权必究】象模式。

本文版权归作者所有，未经授权不得转载。原创内容，盗版必究。 
error.addtrace({
  key: 'name',
  value: 'tomy',
})

message

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

【关注微信公众号：wwwtangshua【作者：唐霜】【转载请注明来源】ngnet】【关注微信公众号：wwwtangshua【原创内容，转载请注明出处】转载请注明出处：www.tangshuang.netngnet】原创内容，盗版必究。【版权所有】唐霜 www.tangshu【访问 www.tangshuang.net 获取更多精彩内容】本文作者：唐霜，转载请注明出处。ang.net 
let error = new HelloType.Error('{name} is wrong.', {
  name: 'tomy',
})

而最终message内容展示出什么内容，未经授权，禁止复制转载。本文版权归作者所有，未经授权不得转载。summary才是message的值的来著作权归作者所有，禁止商业用途转载。未经授权，禁止复制转载。源。这就非常好玩了，有了这样的功能，那么【原创内容，转载请注明出处】【原创不易，请尊重版权】message的内容就可以根据trace未经授权，禁止复制转载。【作者：唐霜】信息发生变化。因此，在创建一个error本文版权归作者所有，未经授权不得转载。【原创不易，请尊重版权】的时候，最好是可以提前通过插值来安排你的【转载请注明来源】【本文首发于唐霜的博客】消息。

【访问 www.tangshuang.n【未经授权禁止转载】【未经授权禁止转载】et 获取更多精彩内容】转载请注明出处：www.tangshua【版权所有】唐霜 www.tangshuang.net【转载请注明来源】ng.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来得到摘要信息，这些信息【本文首发于唐霜的博客】【作者：唐霜】将被用作构建message的材料，你可以原创内容，盗版必究。本文作者：唐霜，转载请注明出处。直接在message中使用它们。它有几个【版权所有】唐霜 www.tangshuang.net本文版权归作者所有，未经授权不得转载。非常有用的属性：keyPath、shou本文版权归作者所有，未经授权不得转载。本文作者：唐霜，转载请注明出处。ld、receive。

转载请注明出处：www.tangshua本文版权归作者所有，未经授权不得转载。未经授权，禁止复制转载。ng.net【版权所有】唐霜 www.tangshu【本文首发于唐霜的博客】本文作者：唐霜，转载请注明出处。ang.net【作者：唐霜】 
console.log(error.summary.stack)

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

转载请注明出处：www.tangshua未经授权，禁止复制转载。未经授权，禁止复制转载。ng.net【版权所有】唐霜 www.tangshu著作权归作者所有，禁止商业用途转载。【未经授权禁止转载】ang.net【关注微信公众号：wwwtangshua【原创不易，请尊重版权】原创内容，盗版必究。ngnet】

translate(message, replace)

不过，一般情况下，HelloType抛出【本文首发于唐霜的博客】【未经授权禁止转载】的错误，都是提前预设好了message的【版权所有，侵权必究】著作权归作者所有，禁止商业用途转载。。下文会讲怎么修改默认的message，【版权所有】唐霜 www.tangshuang.net未经授权，禁止复制转载。但是，如果你在得到一个error的时候，未经授权，禁止复制转载。【原创内容，转载请注明出处】又不想用它默认的message，想在特殊【原创不易，请尊重版权】【版权所有】唐霜 www.tangshuang.net情况下，提供特殊的message信息。这【本文首发于唐霜的博客】【未经授权禁止转载】个时候，可以使用error的transl【关注微信公众号：wwwtangshuangnet】【版权所有】唐霜 www.tangshuang.netate方法：

著作权归作者所有，禁止商业用途转载。【原创内容，转载请注明出处】 
let msg = error.translate('{keyPath}不在{receive}中。')
console.log(msg)

这样，你就可以利用error的summa本文作者：唐霜，转载请注明出处。【原创内容，转载请注明出处】ry来得到一个新的message信息，在原创内容，盗版必究。转载请注明出处：www.tangshuang.net特殊情况下，返回特殊文本体现。具体的案例本文作者：唐霜，转载请注明出处。未经授权，禁止复制转载。，你可以看下我github上exampl本文作者：唐霜，转载请注明出处。转载请注明出处：www.tangshuang.netes目录下的例子。

【访问 www.tangshuang.n本文版权归作者所有，未经授权不得转载。【关注微信公众号：wwwtangshuangnet】et 获取更多精彩内容】未经授权，禁止复制转载。【版权所有，侵权必究】【关注微信公众号：wwwtangshua【本文受版权保护】本文版权归作者所有，未经授权不得转载。ngnet】

它的第二个参数是一个Boolean变量，原创内容，盗版必究。本文版权归作者所有，未经授权不得转载。当设置为true时，表示经过transl【转载请注明来源】【关注微信公众号：wwwtangshuangnet】ate之后，替换掉原始的error.me【关注微信公众号：wwwtangshuangnet】【本文受版权保护】ssage，下一次你再读取error.m【本文受版权保护】【未经授权禁止转载】essage将会是经过translate转载请注明出处：www.tangshuang.net【原创内容，转载请注明出处】之后的内容。

著作权归作者所有，禁止商业用途转载。本文作者：唐霜，转载请注明出处。 
error.translate('{keyPath}不在{receive}中。', true)
console.log(error.message)

messages

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

转载请注明出处：www.tangshua【转载请注明来源】【本文受版权保护】ng.net【本文首发于唐霜的博客】【未经授权禁止转载】 
HelloType.Error.messages.refuse = '{keyPath}不符合类型{should}，接收到的是{receive}。'

你也可以打印出HelloType.Err【版权所有，侵权必究】【版权所有】唐霜 www.tangshuang.netor.messages来看看messag【访问 www.tangshuang.net 获取更多精彩内容】【作者：唐霜】es里面到底都有些什么，以此决定都要修改【版权所有，侵权必究】【关注微信公众号：wwwtangshuangnet】什么。

著作权归作者所有，禁止商业用途转载。未经授权，禁止复制转载。【版权所有】唐霜 www.tangshu著作权归作者所有，禁止商业用途转载。【版权所有】唐霜 www.tangshuang.netang.net

结束语

以上就是有关HelloType的所有使用原创内容，盗版必究。【原创不易，请尊重版权】方法，当然，有一些隐性的东西我不会透露出【转载请注明来源】未经授权，禁止复制转载。来，因为有些方法并不常用，或者不应该用，【版权所有，侵权必究】【作者：唐霜】有兴趣的读者可以自己去阅读源码是怎么实现【版权所有】唐霜 www.tangshuang.net转载请注明出处：www.tangshuang.net的。

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

HelloType是我花了一个周末时间写【访问 www.tangshuang.net 获取更多精彩内容】本文版权归作者所有，未经授权不得转载。完的，但后面陆续又花了几周把最终的形态确【本文受版权保护】原创内容，盗版必究。定下来，可以说是这段时间在api数据检查【本文受版权保护】原创内容，盗版必究。过程中拼命挣扎的结果。

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

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

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

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

2018-08-26 | , ,

已有20条评论
  1. sunflower 2019-03-08 20:37

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

    回复
  2. 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)

  3. qte 2019-01-04 17:01

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

    回复
    • 否子戈 2019-01-04 22:19

      感谢指出单词拼写错误！！！
      不过你指出的无法打印错误的情况我没遇到，可否将你的用法贴出来看下

      回复
  4. 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

  5. 玲玲 2018-12-27 18:09

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

    回复
    • 否子戈 2018-12-27 18:11

      可以用IfNotMatch试试

      回复
      • 玲玲 2018-12-27 20:25

        IfNotMatch(String) 第二个参数是默认值转了

        回复
        • 否子戈 2018-12-27 23:29

          没明白你意思

          回复