chai断言库
chai简介
chai.js 是一套TDD(测试驱动开发)/BDD(行为驱动开发)的断言库。包含有3个断言库支持BDD风格的expect/should,和TDD风格的assert。BDD风格就是你的测试代码更加的语义化,让你的断言可读性更好,expect/should库都支持链式调用,可以在node和浏览器环境运行,可以高效的和任何js测试框架搭配使用。
说明:BDD:行为驱动开发(注重测试逻辑) TDD:测试驱动开发(注重输出结果)
expect 和 should 是BDD风格的,二者使用相同的链式语言来组织断言,但不同在于他们初始化断言的方式:expect使用构造函数来创建断言对象实例,而should通过为Object.prototype新增方法来实现断言(所以should不支持IE);expect直接指向chai.expect,而should则是chai.should()。
语言链
下面的接口是单纯作为语言链提供以期提高断言的可读性。除非被插件改写否则它们一般不提供测试功能:
to,be,been,is,that,which,and,has,have,with,at,of,same。
常见的断言
.not:对之后的断言取反
.deep:设置deep标记,然后使用 equal 和 property 断言。该标记可以让其后的断言不是比较对象本身,而是递归比较对象的键值对。deep.property 中的特殊符号可以使用双反斜杠进行转义(第一个反斜杠是在字符串参数中对第二个反斜杠进行转义,第二个反斜杠用于在property中进行转义)
.any:在keys断言之前使用any标记(与all相反)
.all:在keys断言之前使用all标记(与any相反)
.a(type) / .an(type): type:String,被测试的值的类型;a 和 an 断言即可作为语言链又可作为断言使用
.include(value) / contains(value):value:Object | String | Number;include()和contains()即可作为属性类断言前缀语言链又可作为作为判断数组、字符串是否包含某值的断言使用。当作为语言链使用时,常用于key()断言之前
.ok:断言目标为真值
.true:断言目标为true,这里与ok的区别是不进行类型转换,只能为true才能通过断言
.exist:断言目标存在,即非null也非undefined
.empty:断言目标的长度为0。对于数组和字符串,它检查length属性,对于对象,它检查可枚举属性的数量
.arguments:断言目标是一个参数对象arguments
.equal(value):value:Mixed;断言目标严格等于(===)value。另外,如果设置了deep标记,则断言目标深度等于value
.above(value):value: Number;断言目标大于(超过)value
.least(value):value: Number;断言目标不小于(大于或等于)value
.below(value):value:Number;断言目标小于value
.most(value):value:String;断言目标不大于(小于或等于)value
.within(start, finish):start:Number,下限;finish:Number,上限;断言目标在某个区间内
.instanceof(constructor):constructor:Constructor,构造函数;断言目标是构造函数constructor的一个实例
.property(name, [value]):name:String,属性名;value:Mixed,可选,属性值;
断言目标是否拥有某个名为name的属性,可选地如果提供了value则该属性值还需要严格等于(===)value。如果设置了deep标记,则可以使用点.和中括号[]来指向对象和数组中的深层属性;
如果目标是一个数组,还可以直接使用一个或多个数组下标作为name来在嵌套数组中断言deep.property;
此外,property把断言的主语(subject)从原来的对象变为当前属性的值,使得可以在其后进一步衔接其它链式断言(来针对这个属性值进行测试);
注意,只有当设置了deep标记的时候,在property() name中的点(.)和中括号([])才必须使用双反斜杠\进行转义(为什么是双反斜杠,在前文有提及),当没有设置deep标记的时候,是不能进行转义的
.ownProperty(name):name:String,属性名;断言目标拥有名为name的自有属性
.length:设置.have.length标记作为比较 length 属性值的前缀
.lengthOf(value):value:Number;断言目标的length属性为期望的值
.match(regexp):regexp:RegExp,正则表达式;断言目标匹配到一个正则表达式
.string(string):string:String,字符串;断言目标字符串包含另一个字符串
.keys(key1, [key2], [...]):key:String | Array | Object 属性名
断言目标包含传入的属性名。与any,all,contains或者have前缀结合使用会影响测试结果:
当与any结合使用时,无论是使用have还是使用contains前缀,目标必须至少存在一个传入的属性名才能通过测试。注意,any或者all应当至少使用一个,否则默认为all
当结合all和contains使用时,目标对象必须至少拥有全部传入的属性名,但是它也可以拥有其它属性名
当结合all和have使用时,目标对象必须且仅能拥有全部传入的属性名
还有很多,这里就不一一列举了