Jasmine梳理

时间 2019-11-16

标签 jasmine 梳理繁體版

原文原文链接

Jasmine

Jasmine描述

Suites(describe)是Jasmine的核心，里面包括多个specs测试体(it)，而每一个测试体specs里面可能包含多个断言(expect)；html

jasmine API

`describe()` 测试集

/*@param
*   string     用于描述测试组的名称
*   function   是测试组的主体函数
*/

describe("测试集描述", function () {
    // 测试集主体函数
})

`it()` 测试体，包含在`describe()`，传入两个参数

/*@param
*    string     用于描述测试体的名称
*    function   是测试体的主体函数
*/
describe("测试集描述", function () {
    it("测试体描述",function(){
        // 测试体主体函数
    })
})

四个全局函数 (和it同级)

beforeEach() 在describe函数中每一个Spec(it)执行以前执行。git
afterEach() 在describe函数中每一个Spec(it)数执行以后执行。github
beforeAll() 在describe函数中全部的Spec(it)执行以前执行，但只执行一次，在Sepc之间并不会被执行。正则表达式
afterAll() 在describe函数中全部的Spec(it)执行以后执行，但只执行一次，在Sepc之间并不会被执行。api

describe("测试集描述", function () {
    beforeEach(function(){
        // 每一个it执行前执行函数体
    })
})

`expect()` 断言，传递一个参数，接收实际值，后面紧跟着一个Matchers()，来进行判断是否经过

describe("测试集描述", function () {
    it("测试体描述",function(){
        var a=true;
        expect(a).toEqual(true);
    })
})

`Matchers()` 常见的有：

not 表示对下面断言的否认数组
toBe() 判断两个变量是否全等，相似于“===”；框架
toNotBe() 与上一个相反，判断两个变量是否不全等，相似于“!==”；函数
toEqual() 判断变量是否相等，至关于“==”；单元测试
toThrow() 检验一个函数是否会抛出一个错误。测试
toBeDefined() 检查变量或属性是否已声明且赋值（是否不等于undefined）；
toBeUndefined() 检查变量或属性是否已声明且赋值（是否等于undefined）；
toBeNull() 判断变量是否为null；
toBeTruthy() 判断变量若是转换为布尔值，是否为true；
toBeFalsy() 判断变量若是转换为布尔值，是否为false；
toBeLessThan() 与数值比较，是否小于；
toBeGreaterThan() 与数值比较，是否大于；
toContain() 判断一个数组中是否包含元素（值）。只能用于数组，不能用于对象；
toBeCloseTo() 数值比较时定义精度，先四舍五入后再比较；
toMatch() 按正则表达式匹配；
toNotMatch() 不按正则表达式匹配；

describe("测试集描述", function () {
    it("测试体描述",function(){
        var a=true;
        expect(a).not.toEqual(false);
    })
})

闲置测试

在describe和it前加一个x，变成xdescribe,xit,就能够闲置该测试，这样运行时就不会自动测试，须要手动开始。

xdescribe("测试集描述", function () {
    xit("测试体描述",function(){

    })
})

自定义Matchers

jasmine.addMatchers({
    mySelfMatcher: function () {  //定义断言的名字
        return {
            compare: function (actual, expected) {  //compare是必须的
                return {
                    pass: actual === expected,
                    message: "song is not current playing"  //断言为false时的信息
                }  //要返回一个带pass属性的对象，pass就是须要返回的布尔值
            }
            //negativeCompare: function(actual, expected){ ... }  //自定义not.的用法
        };
    }
});

调用

...
// actual 为要测试的值，expect指望值
expect(actual).mySelfMatcher(expect);

spy

能监测任何function的调用和方法参数的调用痕迹,可是不会影响函数真实返回值，需使用2个特殊的Matcher

toHaveBeenCalled 能够检查function是否被调用过

toHaveBeenCalledWith 能够检查传入参数是否被做为参数调用过

describe("spy", function() {
var foo, bar = null;

beforeEach(function() {
  foo = {
setBar: function(value) {
  bar = value;
}
  };

  spyOn(foo, 'setBar');

  foo.setBar(123); rue
  foo.setBar(456, 'another param');
});

it("跟踪函数调用状况", function() {
  // 上面调用了foo.setBar,因此返回true
  expect(foo.setBar).toHaveBeenCalled();
  // 上面调用了foo.setBar,而且传入参数123，因此返回true
  expect(foo.setBar).toHaveBeenCalledWith(456, 'another param');

  // Spy的调用并不会影响真实的值，因此bar仍然是null。
  expect(bar).toBeNull();
});
});

and.callThrough 若是在spyOn以后链式调用and.callThrough，那么Spy除了跟踪全部的函数调用外，而且Spy返回的值是函数调用后实际的值。

describe("spy", function() {
...
spyOn(foo, 'setBar').and.callThrough();
foo.setBar(123);

it("跟踪函数调用状况", function() {
  // Spy后面添加了and.callThrough()，返回的值是函数调用后实际的值，因此此时bar变为了123，而不是null。
  expect(bar).toEqual(123);
});
});

and.stub 在调用and.callThrough()后，能够阻止spy对实际值的影响，也就是将and.callThrough()方法执行之后进行还原

describe("spy", function() {
  ...
  it("跟踪函数调用状况", function() {
  spyOn(foo, 'setBar').and.callThrough();
  foo.setBar(123);
  expect(bar).toEqual(123);  // 调用and.callThrough(),影响了bar的值

  bar = null;
  foo.setBar.and.stub();// 调用and.stub()后，以后调用foo.setBar将不会影响bar的值。
  foo.setBar(123);
  expect(bar).toBeNull();// 没有影响bar的值，bar此时为null
  });
});

参考文章：

JavaScript单元测试框架-Jasmine

官方文档