断言主要应用于“调试”与“测试”

一、前端中的断言

仔细地查找一下JavaScript中的API，实际上并没有多少关于断言的方法。唯一一个就是console.assert：

  // console.assert(condition, message)const a = '1'console.assert(typeof a === 'number', 'a should be Number')

当condition为false时，该方法则会将错误消息写入控制台。如果为true，则无任何反应。

实际上，很少使用console.assert方法，如果你阅读过vue或者vuex等开源项目，会发现他们都定制了断言方法：

  // Vuex源码中的工具函数function assert (condition, msg) {if (!condition) {throw new Error(`[Vuex] ${msg}`)}}

二、Node中的断言

Node中内置断言库(assert)，这里我们可以看一个简单的例子：

  try {assert(false, '这个值应该是true')} catch(e) {console.log(e instanceof assert.AssertionError) // trueconst { actual, expected, operator } = econsole.log(`实际值： ${actual}，期望值： ${expected}, 使用的运算符：${operator}`)// 实际值： false，期望值： true, 使用的运算符：==}

assert模块提供了不少的方法，例如strictEqual、deepStrictEqual、notDeepStrictEqual等，仔细观察这几个方法，我们又得来回顾一下JavaScript中的相等比较算法：

• 抽象相等比较算法 (==)
• 严格相等比较算法 (===)
• SameValue (Object.is())
• SameValueZero

几个方法的区别可以查看这可能是你学习ES7遗漏的知识点。

在Node10.2.0文档中你会发现像assert.equal、assert.deepEqual这样的api已经被废除，也正是避免==的复杂性带来的易错性。而保留下来的api基本上多是采用后几种算法，例如：

• strictEqual使用了严格比较算法
• deepStrictEqual在比较原始值时采用SameValue算法

三、chai.js

从上面的例子可以发现，JavaScript中内置的断言方法并不是特别的全面，所以这里我们可以选择一些三方库来满足我们的需求。

这里我们可以选择chai.js，它支持两种风格的断言（TDD和BDD）：

  const chai = require('chai')const assert = chai.assertconst should = chai.should()const expect = chai.expectconst foo = 'foo'// TDD风格 assertassert.typeOf(foo, 'string')// BDD风格 shouldfoo.should.be.a('string')// BDD风格 expectexpect(foo).to.be.a('string')

大部分人多会选择expect断言库，的确用起来感觉不错。具体可以查看官方文档，毕竟确认过眼神，才能选择适合的库。

四、expect.js源码分析

expect.js不仅提供了丰富的调用方法，更重要的就是它提供了类似自然语言的链式调用。

链式调用

谈到链式调用，我们一般会采用在需要链式调用的函数中返回this的方法实现：

  class Person {constructor (name, age) {this.name = namethis.age = age}updateName (val) {this.name = valreturn this}updateAge (val) {this.age = valreturn this}sayHi () {console.log(`my name is ${this.name}, ${this.age} years old`)}}const p = new Person({ name: 'xiaoyun', age: 10 })p.updateAge(12).updateName('xiao ming').sayHi()

然而在expect.js中并不仅仅采用这样的方式实现链式调用，首先我们要知道expect实际上是Assertion的实例:

  function expect (obj) {return new Assertion(obj)}

接下来看核心的Assertion构造函数:

  function Assertion (obj, flag, parent) {this.obj = obj;this.flags = {};// 通过flags记录链式调用用到的那些标记符，// 主要用于一些限定条件的判断，比如not，最终返回结果时会通过查询flags中的not是否为true,来决定最终返回结果if (undefined != parent) {this.flags[flag] = true;for (var i in parent.flags) {if (parent.flags.hasOwnProperty(i)) {this.flags[i] = true;}}}// 递归注册Assertion实例，所以expect是一个嵌套对象var $flags = flag ? flags[flag] : keys(flags), self = this;if ($flags) {for (var i = 0, l = $flags.length; i < l; i  ) {// 避免进入死循环if (this.flags[$flags[i]]) {continue}var name = $flags[i], assertion = new Assertion(this.obj, name, this)// 这里要明白修饰符中有一部分也是Assertion原型上的方法，例如 an, be。if ('function' == typeof Assertion.prototype[name]) {// 克隆原型上的方法var old = this[name];this[name] = function () {return old.apply(self, arguments);};// 因为当前是个函数对象，你要是在后面链式调用了Assertion原型上方法是找不到的。// 所以要将Assertion原型链上的所有的方法设置到当前的对象上for (var fn in Assertion.prototype) {if (Assertion.prototype.hasOwnProperty(fn) && fn != name) {this[name][fn] = bind(assertion[fn], assertion);}}} else {this[name] = assertion;}}}}

为什么要这样设计？我的理解是：首先expect.js的链式调用充分的体现了调用的逻辑性，而这种嵌套的结构真正的体现了各个修饰符之间的逻辑性。

所以我们可以这样书写：

  const student = {name: 'xiaoming',age: 20}expect(student).to.be.a('object')

当然这并没有完，对于每一个Assertion原型上的方法多会直接或者间接的调用assert方法：

  Assertion.prototype.assert = function (truth, msg, error, expected) {// 这就是flags属性的作用之一var msg = this.flags.not ? error : msg, ok = this.flags.not ? !truth : truth, err;if (!ok) {// 抛出错误err = new Error(msg.call(this));if (arguments.length > 3) {err.actual = this.obj;err.expected = expected;err.showDiff = true;}throw err;}// 为什么这里要再创建一个Assertion实例？也正是由于expect实例是一个嵌套对象。this.and = new Assertion(this.obj);};

并且每一个Assertion原型上的方法最终通过返回this来实现链式调用。所以我们还可以这样写：

  expect(student).to.be.a('object').and.to.have.property('name')

到此你应该已经理解了expect.js的链式调用的原理，总结起来就是两点：

• 原型方法还是通过返回this，实现链式调用；
• 通过嵌套结构的实例对象增强链式调用的逻辑性；

所以我们完全可以这样写：

  // 强烈不推荐 不然怎么能属于BDD风格呢？expect(student).a('object').property('name')

---

    喜欢本文的小伙伴们,欢迎关注我的订阅号超爱敲代码,查看更多内容.