上手 Jest 测试框架 入门教程

在这里插入图片描述

当我第一次听说TDD(Test-Driven Develop, 测试驱动开发)的时候,我首先想到的是测试小姐姐们想搞事情?后面发现这个玩意儿是想干掉测试,那好,下面开始让我们干掉这群整天给我们找bug…下面开始从简单的单元测试上手Jest测试框架。

我们能学到什么

  1. Jest怎么4行代码完成一个测试用例

  2. Jest怎么让测试用例覆盖率100%

  3. Jest怎么和Typescript完美结合(填坑实录)

  4. Jest最锋利的功能 Mock Functions

本文所涉及的源代码都放在了 Github 上。

项目初始化


创建工程



  1. # 注意powershell中'&&'替换为';'


  2. mkdir jest-just-go && cd jest-just-go



初始化

npm init -y


安装依赖

npm i jest --save-dev


1.Jest怎么4行代码完成一个测试用例


初始化Jest默认配置

npx jest --init


初始化时会出现提示信息,按y或enter即可。

编写功能代码


现在让我们正式开始,茶和图雀社区精心准备的甜品更搭哦。


在项目根目录下新建src目录,存放我们的功能代码。然后创建src/dessert.js



  1. const dessert = function (name) {


  2. this.name = name;


  3. }




  4. dessert.prototype = {


  5. enjoy: function () {


  6. return "Enjoy the " + this.name;


  7. }


  8. }




  9. module.exports = dessert;



我们已经编写了一个甜品类型,它有一个提供品尝的方法enjoy

编写测试用例


下面开始编码,实现对上面甜品功能的单元测试。


在项目根目录下新建__tests__目录,存放我们的测试用例。然后创建__tests__/dessert.test.js



  1. const dessert = require("../src/dessert");




  2. describe("test dessert feature", () => {


  3. test("enjoy the cake", () => {


  4. const cake = new dessert('cake');


  5. expect(cake.enjoy()).toBe("Enjoy the cake");


  6. })


  7. })



简单的四行代码,我们的第一个测试用例就已经大功告成。这里我们只需要注意 describetestexpect 这3个 Jest 关键字就行了:

  1. describe:组合同一类的 test 用例,可以添加 beforeEach \ afterEach、beforeAll \ afterAll (这里由于篇幅,这一类进阶特性将放在后续的教程中)为其下所有 test 进行统一描述和处理。

  2. test:描述具体的测试用例,是单元测试的最小单元。

  3. expect: Jest 最终落在了每一个对测试结果的 期望 上,通过 expect 中的返回值或是函数执行结果来和期望值进行对比。

执行测试


回到控制台,输入:

npm test


无需更多配置,测试结果显示如下:





其中:

  • %Stmts 是语句覆盖率(statement coverage):是不是每个语句都执行了?

  • %Branch 分支覆盖率(branch coverage):是不是每个if代码块都执行了?

  • %Funcs 函数覆盖率(function coverage):是不是每个函数都调用了?

  • %Lines 行覆盖率(line coverage):是不是每一行都执行了?

%Stmts 和 %Lines 的区别是:行覆盖率的颗粒度是大于语句覆盖率的,因为可能允许一行中有多条语句(js开发中尤为常见)。


我们更改__tests__/dessert.test.js



  1. expect(cake.enjoy()).toBe("Enjoy the cake");


  2. 改为


  3. expect(cake.enjoy()).toBe("enjoy the cake");



执行测试命令查看测试不通过的情形:




2.Jest怎么让测试用例覆盖率达到100%


当我们的功能场景逐渐变得复杂,我们的测试就必须确保测试用例的覆盖率达到一个标准。最佳当然是100%啦,这样才能保证测试小改改们找不到我们的茬,闲的没事就会主动找我们拉话话啦,美好生活从测试用例覆盖率100%开始。

编写功能代码


甜点不够怎么办?要不我们开家店吧!先让红豆烧和提拉米苏够吃先~



  1. const dessert = require("./dessert");




  2. const dessertFactory = function () {


  3. }




  4. dessertFactory.produce = function (type) {


  5. switch (type) {


  6. case 'Red bean burning':


  7. return new dessert('Red bean burning'); // 红豆烧


  8. case 'Tiramisu':


  9. return new dessert('Tiramisu'); // 提拉米苏


  10. default:


  11. throw new Error("please choose a dessert type");


  12. }


  13. }




  14. module.exports = dessertFactory;



现在想吃什么通过dessertFactory.produce(...)order就fine啦~

编写测试用例


不过,要保证我们想吃的时候就必须能吃到(这个很重要),我们先验收先:


__tests__/dessertFactory.test.js



  1. const dessertFactoty = require("../src/dessertFactoty");




  2. describe("test dessertFactoty feature", () => {


  3. test("produce all dessert", () => {


  4. const dessertType = ['Red bean burning', 'Tiramisu'];


  5. expect(dessertFactoty.produce(dessertType[0]).enjoy()).toBe("Enjoy the Red bean burning");


  6. })


  7. })



–“我不要你觉得,我要我觉得“,我要上档次的“验收报告“!


–行,网页展示出来怎么样


配置jest.config.js保存测试用例覆盖率执行报告


我们在执初始化Jest默认配置的时候,会生成在项目根目录下生成jest.config.js,里面列出了所有的配置项,未设置的已经被注释掉了。我们要将每次执行测试后生成的覆盖率报告保存下来需要找到下面这项配置属性并更改:



  1. // Indicates whether the coverage information should be collected while executing the test


  2. collectCoverage: true,



然后我们可以再次执行测试命令并用浏览器打开_/coverage/lcov-report/index.html_查看测试用例覆盖率报告:




修改测试用例使覆盖率达到100%


__tests__/dessertFactory.test.js



  1. const dessertFactoty = require("../src/dessertFactoty");




  2. describe("test dessertFactoty feature", () => {


  3. test("produce all dessert", () => {


  4. const dessertType = ['Red bean burning', 'Tiramisu'];


  5. expect(dessertFactoty.produce(dessertType[0]).enjoy()).toBe("Enjoy the Red bean burning");


  6. expect(dessertFactoty.produce(dessertType[1]).enjoy()).toBe("Enjoy the Tiramisu");


  7. expect(() => { dessertFactoty.produce('Luckin Coffee') }).toThrow("please choose a dessert type");


  8. })


  9. })



再测试并查看覆盖率报告:





这里 Functions列 为什么不是100%,大家可以点击 dessertFactory.js 根据详细说明分析推测。


3.Jest怎么和Typescript完美结合(填坑实录)


搜索引擎上现有的 Jest + Typescript 的样例比较少,并且存在了一定的问题没有解决,这一部分我已经填平了坑,可以作为配置参考。

增加依赖

npm i ts-jest @types/jest typescript @types/node --save-dev


其中 ts-jest 为 Jest + Typescript 环境下进行测试提供了类型检查支持和预处理。

ts初始化


在根目录下创建配置文件tsconfig.json



  1. {


  2. "compilerOptions": {


  3. "target": "es5",


  4. "module": "commonjs",


  5. "lib": [


  6. "es2015"


  7. ],


  8. "strict": true,


  9. "declaration": true,


  10. "outDir": "build",


  11. "sourceMap": true


  12. },


  13. "include": [


  14. "src/**/*"


  15. ],


  16. "exclude": [


  17. "node_modules",


  18. "__test__/**/*"


  19. ]


  20. }



修改jest.config.js配置


添加如下配置项:



  1. // An array of file extensions your modules use


  2. moduleFileExtensions: [


  3. "js",


  4. "json",


  5. "jsx",


  6. "ts",


  7. "tsx",


  8. "node"


  9. ],


  10. // A preset that is used as a base for Jest's configuration


  11. preset: "ts-jest",



修改功能代码


src/dessert.js => src/dessert.ts



  1. export default class dessert {


  2. name: string;


  3. constructor(name: string) {


  4. this.name = name;


  5. }


  6. enjoy() {


  7. return "Enjoy the " + this.name;


  8. }


  9. }



src/dessertFactory.js => src/dessertFactory.ts



  1. import dessert from "./dessert";




  2. export default class dessertFactory {


  3. static produce(type: string) {


  4. switch (type) {


  5. case 'Red bean burning':


  6. return new dessert('Red bean burning'); // 红豆烧


  7. case 'Tiramisu':


  8. return new dessert('Tiramisu'); // 提拉米苏


  9. default:


  10. throw new Error("please choose a dessert type");


  11. }


  12. }


  13. }



修改测试用例


__tests__/dessert.js => __tests__/dessert.ts



  1. import dessert from "../src/dessert";




  2. describe("test dessert feature", () => {


  3. test("enjoy the cake", () => {


  4. const cake = new dessert('cake');


  5. expect(cake.enjoy()).toBe("Enjoy the cake");


  6. })


  7. })



__tests__/dessertFactory.js => __tests__/dessertFactory.ts



  1. import dessertFactoty from "../src/dessertFactoty";




  2. describe("test dessertFactoty feature", () => {


  3. test("produce all dessert", () => {


  4. const dessertType = ['Red bean burning', 'Tiramisu'];


  5. expect(dessertFactoty.produce(dessertType[0]).enjoy()).toBe("Enjoy the Red bean burning");


  6. expect(dessertFactoty.produce(dessertType[1]).enjoy()).toBe("Enjoy the Tiramisu");


  7. expect(() => { dessertFactoty.produce('Luckin Coffee') }).toThrow("please choose a dessert type");


  8. })


  9. })



如同代码重构后我们通过测试用例可以快速检查是否改动出现差错一样,我们这次变更可以执行 Jest 测试命令,检查是否对功能无影响。




4.Jest最锋利的功能 Mock Functions


关于 Jest 测试框架中的Mock功能,我们主要关注两点:

  1. mock function: 对函数进行mock.

  2. mock return value: 对返回值进行mock.


从以上两点可以衍生出 Jest 对于代码单元测试中两项常用的锋利功能:

  1. 对功能中业务逻辑简化后的重新实现,方便有指向性的进行测试(比如忽略实际场景中的跨服务调用功能等,仅需将原有功能中对应的调用逻辑改为定义的测试数据即可)。

  2. 对功能返回值的直接模拟。


为甜点增加了评论功能:



  1. export default class dessert {


  2. name: string;


  3. static comment: string[] = [];


  4. constructor(name: string) {


  5. this.name = name;


  6. }


  7. enjoy() {


  8. return "Enjoy the " + this.name;


  9. }


  10. static comments(message: string) {


  11. dessert.comment.push(message);


  12. }


  13. }



专门建立一个互动区进行甜点的讨论。创建src/dessertCommentModule.ts:



  1. import dessert from "./dessert";




  2. module dessertCommentModule {


  3. export function comments(message: string) {


  4. dessert.comments(message);


  5. return dessert.comment;


  6. }




  7. }




  8. export default dessertCommentModule;



下面开始test dessert feature with mock~这一部分均已通过测试,建议深入研读代码,感受 Jest mock 每一处的奥妙。如果下面各处期望的结果都如你所料,那么你就是图雀社区最靓的仔:



  1. import dessert from "../src/dessert";


  2. import dessertCommentModule from "../src/dessertCommentModule";


  3. jest.mock("../src/dessertCommentModule");




  4. describe("test dessert feature", () => {


  5. test("enjoy the cake", () => {


  6. const cake = new dessert('cake');


  7. expect(cake.enjoy()).toBe("Enjoy the cake");


  8. })


  9. })




  10. describe("test dessert feature with mock", () => {


  11. test("enjoy the cake with mock function", () => {


  12. const dessertFactoryMock = jest.fn(name => new dessert(name));


  13. const cake = dessertFactoryMock('cake');


  14. expect(cake.enjoy()).toBe("Enjoy the cake");


  15. expect(dessertFactoryMock.mock.results[0].value.enjoy()).toBe("Enjoy the cake");


  16. console.log(dessertFactoryMock.mock);


  17. })


  18. test("enjoy the cake with mock return value", () => {


  19. const dessertFactoryMock = jest.fn(name => new dessert(name));


  20. const cake = new dessert('cake');


  21. dessertFactoryMock.mockReturnValue(cake);


  22. const tiramisu = dessertFactoryMock('tiramisu');


  23. expect(tiramisu.enjoy()).toBe("Enjoy the cake");


  24. expect(tiramisu).toEqual(cake);


  25. expect(dessertFactoryMock.mock.results[0].value).toEqual(cake);


  26. })


  27. test("comment the dessert with mock module", () => {


  28. const mockedDessert = dessertCommentModule as jest.Mocked<typeof dessertCommentModule>;


  29. mockedDessert.comments.mockReturnValue(['not bad']);


  30. expect(mockedDessert.comments("cake is so good")).toEqual(['not bad']);


  31. expect(dessert.comment).toEqual([]);


  32. })


  33. test("comment the dessert with mock implementations", () => {


  34. const mockedDessert = dessertCommentModule as jest.Mocked<typeof dessertCommentModule>;


  35. mockedDessert.comments.mockImplementation((message: string) => {


  36. dessert.comments(message);


  37. return ['not bad'];


  38. });


  39. expect(mockedDessert.comments("cake is so good")).toEqual(['not bad']);


  40. expect(dessert.comment).toEqual(['cake is so good']);


  41. })


  42. })



mock function


注意:我们可以更改testtest.only仅对test.only的测试用例执行测试,降低测试时间并关注特定测试点。

test.only("enjoy the cake with mock function", () => {  ...


这里我们通过 jest.fn 进行 了 mock function 功能的展示,通过执行 npm test 看到 .mock 的结构信息:





.mock的中将会记录mock function调用后的相关信息

mock return value



  1. test("enjoy the cake with mock return value", () => {


  2. ....



这里我们通过 .mockReturnValu 可以将 function mock 的操作略过,直接会返回 .mockReturnValue 中填充的返回值。通过执行 npm test 验证。

mock module



  1. import dessertCommentModule from "../src/dessertCommentModule";


  2. jest.mock("../src/dessertCommentModule");


  3. test.only("comment the dessert with mock module", () => {


  4. ...



通过 jest.mock ,我们 mock 了甜点评论区,这项操作可以使我们对dessertCommentModule中的所有功能进行我们的测试定制。这里我们通过对评论功能进行 mock return value ,通过执行 npm test 看到:





并没有进入dessertCommentModule中的comments方法,直接返回了我们预置的返回值。

mock implementations



  1. test.only("comment the dessert with mock implementations", () => {


  2. ...



我们通过对评论功能进行 mock implementations ,通过执行 npm test 看到:





进入了 mockImplementation 中的测试定制功能,并且调用了dessert中的comments方法。


以上。

(完)