1 简介
1.1 Jest 是什么?
Jest 是 Facebook 发布的一个开源的、基于 Jasmine 框架的 JavaScript 单元测试工具。提供了包括内置的测试环境 DOM API 支持、断言库、Mock 库等,还包含了 Snapshot Testing、 Instant Feedback 等特性。它自动集成了断言、JSDom、覆盖率报告等开发者所需要的所有测试工具,是一款几乎零配置的测试框架。并且它对同样是 Facebook 的开源前端框架 React 的测试十分友好。
1.2 谁在用?
1.3 卖点
- Jest 是 Facebook 出品的一个测试框架,相对其他测试框架,其一大特点就是就是内置了常用的测试工具,比如自带断言、测试覆盖率工具,实现了开箱即用。
- 而作为一个面向前端的测试框架, Jest 可以利用其特有的快照测试功能,通过比对 UI 代码生成的快照文件,实现对 React 等常见框架的自动测试。
- 此外, Jest 的测试用例是并行执行的,而且只执行发生改变的文件所对应的测试,提升了测试速度。目前在 Github 上其 star 数已经破万;而除了 Facebook 外,业内其他公司也开始从其它测试框架转向 Jest ,比如 Airbnb 的尝试 ,相信未来 Jest 的发展趋势仍会比较迅猛。
2 课前准备
2.1 测试框架
测试框架的作用是提供一些方便的语法来描述测试用例,以及对用例进行分组。 测试框架可分为两种: TDD (测试驱动开发)和 BDD (行为驱动开发),我理解两者间的区别主要是一些语法上的不同,其中 BDD 提供了提供了可读性更好的用例语法,至于详细的区别可参见The Difference Between TDD and BDD - Josh Davis 一文。 常见的测试框架有 Jasmine, Mocha 以及本文要介绍的 Jest 。
2.2 断言库
断言库主要提供语义化方法,用于对参与测试的值做各种各样的判断。这些语义化方法会返回测试的结果,要么成功、要么失败。常见的断言库有 Should.js, Chai.js 等。
测试覆盖率工具
用于统计测试用例对代码的测试情况,生成相应的报表,比如 istanbul
3 上手
初始化一个项目
mkidr $CODE_PATH && cd $CODE_PATH
npm init -y
npm i -D jest
⚠️ jest 默认不支持es6 如果需要测试es6 需要额外安装
npm i -D babel-jest babel-core babel-preset-env
并且增加.babelrc
配置如下:
{
"presets": ["env"]
}
在package.json
添加测试脚本
{
"scripts": {
"test": "jest",
"test:watch": "jest --watchAll"
}
}
这样我们的食材就准备好了✌️
3.1 第一个例子🌰 1+2 = 3
让我们从写一个两个数相加的示例函数开始。首先,创建 sum.js sum.test.js
文件︰
touch sum.js sum.test.js
code .
::sum.js::
export default function sum(a, b) {
return a + b
}
::sum.test.js::
import sum from './sum'
test('adds 1 + 2 to equal 3', () => {
expect(sum(1, 2)).toBe(3)
})
⚠️ Jest 的测试脚本名形如**.test.js,不论 Jest 是全局运行还是通过npm test运行,它都会执行当前目录下所有的**.test.js 或 *.spec.js 文件、完成测试。
运行npm run test
以上是官网的一个小例子
3.2 新的尝试
🤔 你可以修改下 函数
sum
试试错误的结果
::sum.js::
export default function sum(a, b) {
return a + b + 1
}
运行npm run test
需求分析 ➡️ 写单元测试 ➡️ 写代码 ➡️ 单元测试全部通过
那么为什么要写单元测试?详见写单元测试的重要性
那么就意味着单元测试全部通过就没bug了么?那可不一定
4 常用的几个Jest断言
接下来写一个函数的集合 ::functions.js::和::functions.test.js::来演示一些常用的测试方法
touch functions.js functions.test.js
::functions.js::
export default {
add: (num1, num2) => num1 + num2,
}
::functions.test.js::
import functions from './functions'
const { add } = functions
// toBe
test('Adds 2 + 2 to equal 4', () => {
expect(add(2, 2)).toBe(4)
})
4.1 not
在::functions.test.js::增加测试
...
// not
test('Adds 2 + 2 to NOT equal 5', () => {
expect(functions.add(2, 2)).not.toBe(5);
});
...
.not
修饰符允许你测试结果不等于某个值的情况,这和英语的语法几乎完全一样,很好理解。
4.2 toBeNull
::functions.js::
export default {
add: (num1, num2) => num1 + num2,
isNull: () => null
}
在::functions.test.js::增加测试
// toBeNull
test('Should be null', () => {
expect(isNull()).toBeNull();
});
测试通过
4.3 toBeFalsy
toBeFalsy
判断值是否为false
// toBeFalsy
test('Should be falsy', () => {
expect(undefined).toBeFalsy()
})
4.4 toBeFalsy/toBe
// functions.js
createUser: () => {
const user = { firstName: 'Brad' };
user['lastName'] = 'Traversy';
return user;
}
// functions.test.js
test('User should be Brad Traversy object', () => {
expect(createUser()).toEqual({
firstName: 'Brad',
lastName: 'Traversy'
});
});
⚠️
.toEqual
匹配器会递归的检查对象所有属性和属性值是否相等,所以如果要进行应用类型的比较时,请使用.toEqual
匹配器而不是.toBe
。
4.5 More
jest 使用的断言风格与社区相差无几。
// 数值对比
expect(8).toBeGreaterThan(7)
expect(7).toBeGreaterThanOrEqual(7)
expect(6).toBeLessThan(7)
expect(6).toBeLessThanOrEqual(6)
// Regex 正则匹配
expect('team').not.toMatch(/I/i)
// Arrays
expect(['john', 'karen', 'admin']).toContain('admin');
更多断言方法参见:Expect · Jest
4.6 测试异步
JSONPlaceholder是一个提供免费的在线 REST API 的网站,我们在开发时可以使用它提供的 url 地址测试下网络请求以及请求参数。或者当我们程序需要获取一些假数据、假图片时也可以使用它。
// functions.js
fetchUser: () =>
axios
.get('https://jsonplaceholder.typicode.com/users/1')
.then(res => res.data)
// functions.test.js
// Async Await
test('User fetched name should be Leanne Graham', async () => {
expect.assertions(1)
const data = await functions.fetchUser()
expect(data.name).toEqual('Leanne Graham')
})
上面我们调用了expect.assertions(1),它能确保在异步的测试用例中,有一个断言会在回调函数中被执行。这在进行异步代码的测试中十分有效。doc.ebichu.cc/jest/docs/z… 具体的文档说明。
5 实战
5.1 chunkArray
来写个函数::chunkArray:: 将数组array
拆分成多个 size
长度的区块,并将这些区块组成一个新数组。 如果array 无法被分割成全部等长的区块,那么最后剩余的元素将组成一个区块。
举例:
- 实例1: 数组
[1,2,3,4,5,6,7,8,9,10]
拆分的size 为2 那么 最后输出结果为[[1,2],[3,4],[5,6],[7,8],[9,10]]
- 实例2: 数组
[1,2,3,4,5,6,7]
拆分的size 为3 那么输出结果为[[1,2,3],[4,5,6],[7]
以上就是分析过程,也就是我们日常开发中的需求描述,现在我们把需求转换成单测 ::chunkArray.test.js::
// 确认chunkArray 已经被声明定义
test('chunkArray function exists', () => {
expect(chunkArray).toBeDefined()
})
// 验证实例1
test('Chunk an array of 10 values with length of 2', () => {
const numbers = [1, 2, 3, 4, 5, 6, 7, 8, 9, 10];
const len = 2;
const chunkedArr = chunkArray(numbers, len);
expect(chunkedArr).toEqual([[1, 2], [3, 4], [5, 6], [7, 8], [9, 10]]);
});
// 验证实例2
test('Chunk an array of 10 values with length of 2', () => {
const numbers = [1, 2, 3, 4, 5, 6, 7]
const len = 3
const chunkedArr = chunkArray(numbers, len)
expect(chunkedArr).toEqual([[1, 2, 3],[4, 5, 6], [7])
})
接下来就是写chunkArray函数了,给出参考 ::chunkArray.js::
const chunkArray = (arr, len) => {
// Init chunked arr
const chunkedArr = []
// Loop through arr
arr.forEach(val => {
// Get last element
const last = chunkedArr[chunkedArr.length - 1]
// Check if last and if last length is equal to the chunk len
if (!last || last.length === len) {
chunkedArr.push([val])
} else {
last.push(val)
}
})
return chunkedArr
}
如上,是开发流程,这个玩法在一些算法刷算法的社区也有体现,比如codewars
🤔 写到这里我在思考单元测试的意义在哪?总结如下:
- 写单测的是对需求的梳理,动手写代码之前,让自己对于需求的理解更加明确。
- 单测像一个机器人在帮你值守模块的正确性,随着项目复杂和规模变大,单测能让开发者提前知道因为模块的修改和变动的影响范围。
6 测试覆盖率
Jest 内置了测试覆盖率工具istanbul,在::package.json::中增加配置
"collectCoverage": true,
"coverageReporters": ["json", "html", "text"]
npm run test
在命令行中会出测试覆盖率,
coverage
目录有网页版的报告