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 。