学习node.js 断言的使用详解

assert模块提供了一组简单的断言测试，分严格模式(strict)和遗留模式(legacy)，严格模式下，对比的方式比较严格，比如说，0与’0’比较，会报错，但在遗留模式下是可以通过的。官方推荐使用严格模式, 所以本文基于strict模式下学习。

如何使用严格模式

const assert = require('assert').strict; // 严格模式
assert.equal(0, '0') // error

全局使用strict模式后，assert.equal() 与assert.strictEqual()的效果是一样的。

如果不想全局使用的话，可以直接使用带strict的方法。

const assert = require('assert') // 遗留模式
assert.equal(0, '0') // success
assert.strictEqual(0, '0') // error

assert.AssertionError

Error的子类，表示断言失败，assert模块抛出的错误都是AssertionError的实例。

类似于下面这个class，实际上的AssertionError是由ES5写的，下面这个只是方便理解传入的参数

interface IOptions {
 message?: string; // 设置错误的信息
 actual?: any; // 设置错误实例上的实际值
 expected?: any; // 设置错误实例上的期望值
 operator?: string; // 设置用于比较的操作或触发错误的断言函数
 stackStartFn(): any; // 生成的堆栈跟踪将移除所有帧直到提供的函数
}
class AssertionError extends Error {
 constructor(options: IOptions) {
  // ...
 }
}

assert(value: any, message?: string | Error)

检测是否为真值，是assert.ok的别名。

assert.ok(value: any, message?: string | Error)

检测value是否为真值。

如果不为真值，抛出属性message为message参数值的AssertionError，如果未定义，为默认错误信息。

如果是Error的实例，则抛出Error实例。(以下关于message的使用都一样)

assert.strictEqual(actual: any, expected: any, message?: string | Error)

检测 actual参数和expected参数之间的严格相等性，使用sameValue比较。

assert.deepStrictEqual(actual: any, expected: any, message?: string | Error)

检测actual参数和expected参数之间的深度严格相等性，深度比较意味着子对象的可枚举的自身属性也通过以下规则进行递归计算。

assert.notStrictEqual(actual: any, expected: any, message?: string | Error)

检测 actual参数和expected参数之间的严格不相等性，使用sameValue比较。

assert.notDeepStrictEqual(actual: any, expected: any, message?: string | Error)

检测actual参数和expected参数之间的深度严格不相等性，深度比较意味着子对象的可枚举的自身属性也通过以下规则进行递归计算。