Javascript单元测试工具-Jest 学习笔记(一)
写在前面
首先这并不是一篇完整的关于Jest的教程,只是个人在接触jest学习的一点随手笔记,大部分内容都是对官方文档的一些翻译。只是让想了解jest的人快速知道一下jest是做什么的,怎么做。对于如何对项目进行测试,特别是现在很火的React,后面待熟练使用或者会另写一篇心得体会。
What's Jest
Jest是Facebook开发的一个对javascript进行单元测试的工具,之前仅在其内部使用,后开源,并且是在Jasmine测试框架上演变开发而来,使用了我们熟知的expect(value).toBe(other)这种断言格式。
Getting Start
第一个Jest测试Demo
通过npm安装
$ npm install jest --save-dev
编辑一个待测试的sum.js文件如下:
function sum(a, b) {
    return a + b;
}
module.exports = sum;编辑一个测试文件sum.test.js
注意:关于这个测试文件的位置,建议是对每个组件新建一个__test__文件夹,然后文件命名是name.test.js,用于存放测试文件。
const sum = require('./sum');
    
test('adds 1 + 2 to equal 3', ()=> {
    expect(sum(1, 2)).toBe(3);
});接着在package.json文件里添加测试命令
"scripts:" {
    "test": "jest"
}最后,运行 npm test命令后jest将会打印如下信息
PASS ./sum.test.js ✓ adds 1 + 2 to equal 3 (5ms)
至此,第一个测试Demo完成了。
Using Matchers
Jest使用matchers来使用不同的方式测试你的结果。
Common Matchers
最简单的测试方式就是测试一个值是否全等
test('2加2等于4', ()=> {
    expect(2 + 2).toBe(4);
});在上述代码中,expect(2+2)返回一个“期望”对象,通常我们不会对这个期望对象进行匹配,而是由matchers完成,在这里.toBe(4)便是这个matchers,当Jest运行时,它会跟踪所有失败的matchers以便打印正确的错误信息给我们。
toBe使用 === 来测试全等于,如果我们想检查一个对象object中的值,使用toEqual来替代,toEqual递归遍历检查对象或数组里的每一个领域。
"use strict";
    
test('object assigenment', ()=> {
    let data = { one: 1};
    data['two'] = 2;
    expect(data).toEqual({ one: 1, two: 2 });
})注意:官网的例子是没有使用的"use strict";,然后npm test的时候就会报出一条错误
SyntaxError: Block-scoped declarations (let, const, function, class) not yet supported outside strict mode
使用not可以测试一个matchers的反向规则:
test('adding positive numbers is not zero', () => {
    for (let a = 1; a < 10; a++) {
        for (let b = 1; b < 10; b++) {
            expect(a + b).not.toBe(0);
        }
    }
});Truthiness
在测试的时候,有时候我们需要在undefined,null和false进行区别,但是我们又不想去了解他们的不同点,Jest也会帮助我们得到我们想要的结果。
- toBeNull检查是否为null
- toBeUndefined检查是否为undefined
- toBeDefined与- toBeUndefined的相反
- toBeTruthy检查任何通过- if显示转换是否为true
- toBeFalsy检查任何通过- if显示转换是否为false
如下:
test('null', () => {
    let n = null;
      expect(n).toBeNull();
      expect(n).toBeDefined();
      expect(n).not.toBeUndefined();
      expect(n).not.toBeTruthy();
      expect(n).toBeFalsy();
});
test('zero', () => {
      let z = 0;
      expect(z).not.toBeNull();
      expect(z).toBeDefined();
      expect(z).not.toBeUndefined();
      expect(z).not.toBeTruthy();
      expect(z).toBeFalsy();
});Numbers
比较数字的大多数方法都有其对应的matchers
- toBeGreaterThan大于
- toBeGreaterThanOrEqual大于等于
- toBeLessThan小于
- toBeLessThanOrEqual小于等于
test('two plus two', () => {
    let value = 2 + 2;
    expect(value).toBeGreaterThan(3);
    expect(value).toBeGreaterThanOrEqual(3.5);
    expect(value).toBeLessThan(5);
    expect(value).toBeLessThanOrEqual(4.5);
    // toBe and toEqual 对于number类型作用是一样的
    expect(value).toBe(4);
    expect(value).toEqual(4);
});对于浮点数的测试,使用toBeCloseTo来替代toEqual,因为我们不会让一个测试依赖于一个微小的舍入型错误。
test('adding floating point numbers', () => {
    let value = 0.1 + 0.2;
    expect(value).not.toBe(0.3);    // It isn't! Because rounding error
    expect(value).toBeCloseTo(0.3); // This works.
});Strings
使用toMatch对字符串进行正则表达式匹配
test('there is no I in team', () => {
    expect('team').not.toMatch(/I/);
});
test('but there is a "stop" in Christoph', () => {
    expect('Christoph').toMatch(/stop/);
})Arrays
使用toContain对数组内的特定项进行匹配测试
let shoppingList = ['diapers', 'kleenex', 'trash bags', 'paper towels', 'beer'];
test('the shopping list has beer on it', () => {
    expect(shoppingList).toContain('beer');
});Exceptions
使用toThrow对一个特定函数调用时候抛出的错误进行测试
function compileAndroidCode() {
    throw new ConfigError('you are using the wrong JDK');
}
test('compiling android goes as expected', () => {
    expect(compileAndroidCode).toThrow();
    expect(compileAndroidCode).toThrow(ConfigError);
    // You can also use the exact error message or a regexp
    expect(compileAndroidCode).toThrow('you are using the wrong JDK');
    expect(compileAndroidCode).toThrow(/JDK/);
});Testing Asynchronous Code
在javascript程序中,会经常见到一些异步执行的代码,当我们有这些异步执行的代码时,Jest需要知道当前这个代码测试是否已经完成,然后才能转向另一个测试。Jest提供了一些方法来处理这种问题。
Callbacks
最常用的异步测试模式便是callbacks
列如,我们有一个fetchData(callback)方法,当callback(data)方法调用的时候,我们会获取一些data数据,并且想测试返回的数据是否只是一个字符串uyun。
默认情况下下,Jest在所有的代码执行完之后便会完成测试,这意味这些测试不再会按计划的工作下去。
// Don't do this!
test('the data is uyun', () => {
    function callback(data) {
        expect(data).toBe('uyun');
    }
    fetchData(callback);
});问题是,测试希望一旦fatchData成功后才能完成,并在其之前调用回调。
这里有另一种形式修复这个测试的问题,在这个测试方法里使用一个参数为done的回调参数,而不是放置一个空参数,Jest要等到done被调用后才会结束此次测试。
test('the data is uyun', done => {
    function callback(data) {
        expect(data).toBe('uyun');
        done();
    }
    fetchData(callback);
});如果done()没被调用,测试即失败了,这时候我们也会得到我们想要的错误结果了。
Promises
如果我们的代码中使用到了Promises ,这里有一个简单的异步测试处理方法。只是我们的测试中返回一个promise,并且Jest会等待这个promise解析完成,如果rejected了,这个测试便会自动视为失败。如下:
test('the data is uyun', () => {
    return fetchData().then(data => {
        expect(data).toBe('uyun');
    });
});注意:一定要确保返回了promise,如果省略了这步,你的测试将会在fetchData完成之前首先结束掉。
Async/Await
如果代码中使用到async和await,可以这样做。编写一个异步测试,仅需要在测试方法前面使用async关键词,然后传递给测试函数即可。如下:
test('the data is uyun', async () => {
    const data = await fetchData();
    expect(data).toBe('uyun');
});在这个例子中,async和await等同于promises方法的一种语法糖实现方式。
