react 单元测试 (jest+enzyme)

　　为什么要做单元测试

　　作为一个前端工程师，我是很想去谢单元测试的，因为每天的需求很多，还要去编写测试代码，感觉时间都不够用了。

　　不过最近开发了一个比较复杂的项目，让我感觉一旦项目大了、复杂了，而且还是多人维护一个应用，编写测试代码，

　　还是很有必要的。毕竟这样做完之后，后边的维护会轻松很多。

　　单元测试

　　测试代码的最小单元，一个函数就是一个单元

　　测试工具

　　主要用到的测试工具是 jest 和 enzyme

　　jest 、 enzyme 介绍

　　jest 是 facebook 发布的一个开源的，基于 jasmine 框架的 javascript 单元测试工具它提供了很多有效的功能，

　　包含了内置的测试环境的 DOM API 来操作 Dom、断言库、mock 等功能，并且 jest 是 react 的官网上面推荐

　　的工具。

　　enzyme 是 Airbnb 开源的 react 测试类库，提供了一套简洁强大的 api ，可以通过 jq 的风格进行 dom 处理，

　　还可以引用一些其他的 dom 操作库。

　　react 单元测试的搭建

　　react 项目是基于 webpack + babel 来进行构建的。

　　安装 npm 包

　　首先需要添加一些 jest + enzyme 的 npm 包

yarn add jest enzyme babel-jest regenerator-runtime react-test-renderer

　　enzyme 需要安装对应的 react 的 adapter 版本

yarn add enzyme-adapter-react-16

　　配置文件

　　1、package.json

"scripts": {
    "test": "jest --colors --coverage"
  },

　　添加颜色和现实覆盖率

　　.babelrc 文件

"env": { // 单元测试下配置
    "test": {
      "presets": [
        "react",
        "react-optimize",
        [
          "env",
          {
            "modules": "commonjs", // 主要是添加这个
            "debug": true,
            "useBuiltIns": false,
            "targets": {
              "browsers": "defaults"
            }
          }
        ],
        "stage-0"
      ]
    }
  }

　　因为测试环境的在 babel 中的配置 dev 为 test。

　　所以这里需要特殊配置，modules 的形式是 commonjs

　　添加jest配置文件jest.config

module.exports = {
  roots: ['<rootDir>/__test__/', '<rootDir>/src/'], // 测试的目录
  modulePaths: ['<rootDir>'],
  coveragePathIgnorePatterns: ['/node_modules/', '/tests/setup.js'], //忽略统计覆盖率的文件
  // bail: true,
  // testRegex: '', // 后缀名称
  // testPathIgnorePatterns: 'est', // 忽略路径
  // moduleNameMapper: { // 与测试无关的资源文件同意mock 掉，这样在import 的时候就不会真的引入这些文件
  //   '^import?': '<rootDir>/build/jestImportMock.js',
  //   '\\.(css|less|gif|jpg|jpeg|png)$': '<rootDir>/build/jestStyleMock.js',
  // },
};

　　jest 详解

　　1、简单测试结构

function sum(a,b){
    return a+b;
}
 
it('adds 1 + 2 to equal 3', () => {
  expect(sum(1, 2)).toBe(3);
});

　　2、异步的测试结构

async function sum (a,b){
    return a+b;
}
 
it('adds 1 + 2 to equal 3',async () => {
  const total = await sum(1,2)
  expect(total).toBe(3);
});

　　3、Mock Function 结构

function forEach(items, callback) {
  for (let index = 0; index < items.length; index++) {
    callback(items[index]);
  }
}
 
const mockCallback = jest.fn(x => 42 + x);
forEach([0, 1], mockCallback);
 
// 可以 mockCallback.mock 访问 mockCallback 状态

　　1、jest.fn 用来创建一个 mock function

　　2、mockCallback.mock 可以访问 mock function 的状态

　　mock 的属性：

　　calls : 调用的参数数组，保存了每次调用的入参

　　calls.length : 调用次数

　　calls[0][0] : 第一次调用的时候的第一个参数

　　results：调用的结果数组

　　results[0].value : 第一次调用的返回结果

　　执行 mock function

const myMock = jest.fn();
console.log(myMock());
// > undefined
 
myMock
  .mockReturnValueOnce(10)
  .mockReturnValueOnce('x')
  .mockReturnValue(true);
 
console.log(myMock(), myMock(), myMock(), myMock());
//10 x true

　　1、用 mockRetrunValueOnce(value) 来预先设置函数的返回值

　　2、mymock() 返回预先设置的值

　　异步请求的数据模拟

let fetch = {
   get:() =>{}
}
jest.mock(fetch)
fetch.get.mockResolvedValue({data:{},status:0})
fetch.get(url,options)
// {data:{},status:0}

　　4、常用全局方法

　　describe(message,()=>{}) : 创建块

　　it(message,()=>{}) : 测试单元

　　5、ecpect 常用方法

　　expect(value) : 注入测试单元

　　 expect.extend({}) : 拓展 expect 方法

expect.extend({
  toBeBetween(received, arg1, arg2) {
    const min = arg1;
    const max = arg2;
    if (received > min && received < max) {
      return {
        message: '',
        pass: true,
      };
    }
    return {
      message: `received is between in ${min} - ${max}`,
      pass: true,
    };
  },
});
 
expect(99).toBeBetween(1,100)

　　expect.anything() : 返回除了 null 和 undefined 意外的任何类型数据

　　expect.any(Number/String) : 任意数字/字符串

　 expect.assertions(num) : 确定在块中调用几次异步

　　toBe(value) : 等于

　　toHaveBeenCalled() : 确定函数调用

　　toHaveBeenCalledTime(number) : 确定被调用的次数

　　toHaveBeenCalledWith(arg1,arg2) ：取保调用的函数的值

　　toHaveBeenNthCalledWith(num,arg2) : 确保第几个参数

　　toHaveRetruned() ：确保有返回值

　　toHave[:Nth]RetrunedWith([:num,]arg) : 确保某一个有返回值

　　toContain(item) : 数组中是否包含　

　 toMatch(regex) ：正则表达式

　　enzyme

　　enzyme 一共有四个大的 api ( shallow 、mount 、render 、selectors )。

　　通过这四个 api 可以对 react 组件进行操作。

　　我们可以通过类似于 jquery 的操作来进行 test 。