搭建Vue3组件库:第五章 Jest进行前端单元测试

简介: 单元测试是软件质量的重要保证。本章节介绍Jest测试框架。

单元测试是软件质量的重要保证。在 Github 上挑选一款软件,单元测试覆盖率是评价软件成熟度的一个重要指标。通常成熟可靠的开源产品都有完善的单元测试,并且覆盖率可以达到 80% 以上。

本章任务

  • 搭建Jest环境
  • 编写有关Jest的函数
  • 引入DOM仿真,完成一个前端页面测试

task1】搭建 Jest环境

  • 安装依赖
npm i jest -g
  • 根目录创建add.js测试文件

文件名:add.js

const add = (a, b) => a + b;
module.exports = add;
  • 编写Jest测试函数

文件名:src/tests/add.test.js

const add = require("../../add");

describe("测试Add函数", () => {
  test("add(1,2) === 3", () => {
    expect(add(1, 2)).toBe(3);
  });
  test("add(1,1) === 2", () => {
    expect(add(1, 1)).toBe(2);
  });
});
  • 运行jest测试命令
jest

Jest会自动到项目里面查找所有测试用例文件。

如果你想不想使用全局的jest:

pnpm i jest -D

测试命令需要加上npx

npx jest
  • 控制台查看结果
 PASS  tests/add.test.js
  测试Add函数
    √ add(1,2) === 3 (1 ms)                                                                                                               
    √ add(1,1) === 2                                                                                                                      
                                                                                                                                          
Test Suites: 1 passed, 1 total                                                                                                            
Tests:       2 passed, 2 total                                                                                                            
Snapshots:   0 total
Time:        0.483 s
Ran all test suites.

至此测试环境可用。


task2】使用Jest的Mock模拟无法执行的函数

如果被测试的代码,调用了一个网络请求 API ,比如 axios,但是那个网络地址并不存在或者没有联网,这个时候应该如何测试呢?

  • 安装axios开发依赖
pnpm i axios -D
  • 根目录创建fetch.js测试文件
const axios = require('axios')
exports.getData = () => axios.get('/abc/bcd')
单元测试是针对开发的最小单位展开的测试,通常是函数。遇到函数调用函数的情况,比如 A 函数调用 B 函数,测试的主体是 A 函数,B 函数应该与测试无关,应该孤立 B 函数来测试 A 函数。

对于上面的 getData 函数来讲,调用了 axios.get 函数,应该模拟一个 axios.get 函数来替换掉原有的axios.get 函数。模拟的 axios.get 函数不会调用网络请求,只具有根据输入返回相应结果的功能。这个就是Mock函数。

单元测试的任务是验证 getData 函数的功能是否正确,而不是axios.get 函数或者网络接口是否正确。

  • 编写测试文件

首先使用 jest.mock创建一个 axios 的 mock 对象。实际上就是创建了一个虚拟的 axios 函数替换原函数。然后通过 mockResolvedValue 定义调用 axios.get 函数的返回值。这个时候再调用getData() 方法的时候 ,函数内部的 axios.get 是虚拟 mock 函数。调用时不会发生真正的网络请求,只会返回预定的结果。

文件名:src/tests/fetch.test.js

const { getData } = require("../fetch");
const axios = require("axios");
jest.mock("axios");
it("fetch", async () => {
  // 模拟第一次接收到的数据
  axios.get.mockResolvedValueOnce("123");
  // 模拟每一次接收到的数据
  axios.get.mockResolvedValue("456");
    
  const data1 = await getData();
  const data2 = await getData();
  expect(data1).toBe("123");
  expect(data2).toBe("456");
});
  • 执行测试命令
jest
  • 控制台查看结果
 PASS  src/tests/add.test.js
 PASS  src/tests/fetch.test.js
                                                                                                                                          
Test Suites: 2 passed, 2 total                                                                                                            
Tests:       3 passed, 3 total
Snapshots:   0 total
Time:        0.707 s, estimated 1 s
Ran all test suites.

jest.fn()

jest.fn()是创建Mock函数最简单的方式,如果没有定义函数内部的实现,jest.fn()会返回undefined作为返回值。

test('测试jest.fn()调用', () => {
  let mockFn = jest.fn();
  let result = mockFn(1, 2, 3);

  // 断言mockFn的执行后返回undefined
  expect(result).toBeUndefined();
  // 断言mockFn被调用
  expect(mockFn).toBeCalled();
  // 断言mockFn被调用了一次
  expect(mockFn).toBeCalledTimes(1);
  // 断言mockFn传入的参数为1, 2, 3
  expect(mockFn).toHaveBeenCalledWith(1, 2, 3);
})

task3】测试前端页面

前端程序和纯 JS 的区别在于运行时不同。前端程序运行于浏览器端,会直接调用 Dom 对象。但是 Node 中并没有 Dom 模型。

解决的办法有两个 :

  • 将测试用例放到浏览器中运行;
  • dom 仿真模拟一个 dom 对象。

最佳的选择是后者,因为你的测试程序会放到不同的环境中执行,你不可能要求 CI 服务器中也有浏览器。而且放入浏览器再执行,效率也是一个大问题。

模拟一个 dom 对象需要用到 dom 仿真,常见的有 jsdomhappydom

  • 安装依赖
pnpm i jsdom -D
  • 配置jsdom

在 jest 中引入 jsdom ,需要编写一个 jsdom-config.js 文件。

文件名:jsdom-config.js

// jsdom-config.js
const jsdom = require('jsdom') // eslint-disable-line
const { JSDOM } = jsdom

const dom = new JSDOM('<!DOCTYPE html><head/><body></body>', {
  url: 'http://localhost/',
  referrer: 'https://example.com/',
  contentType: 'text/html',
  userAgent: 'Mellblomenator/9000',
  includeNodeLocations: true,
  storageQuota: 10000000,
})
global.window = dom.window
global.document = window.document
global.navigator = window.navigator
  • 编写dom.js被测文件

函数中创建一个 div 元素。

文件名:dom.js

exports.generateDiv = () => {
  const div = document.createElement("div");
  div.className = "c1";
  document.body.appendChild(div);
};
  • 编写dom的测试文件

在测试程序中,被测试函数创建了一个 div 元素,接着就可以在 dom 仿真中获取 div 元素了。也可以用断言来判断代码功能是否正常。

文件名:src/tests/dom.test.js

const { generateDiv } = require('../dom') 
require('../../jsdom-config')
describe('Dom测试', () => {
    
    test('测试dom操作', () => {
        generateDiv()
        expect(document.getElementsByClassName('c1').length).toBe(1)
    })
})
  • 执行jest命令
jest
  • 控制台查看结果
 PASS  src/tests/fetch.test.js
 PASS  src/tests/add.test.js
 PASS  src/tests/dom.test.js
                                                                                                                                          
Test Suites: 3 passed, 3 total                                                                                                            
Tests:       5 passed, 5 total
Snapshots:   0 total
Time:        1.647 s
Ran all test suites.

这个就是 dom 测试。前端常用的 Vue React 程序也都可以使用这样的方法进行测试。

相关文章
|
4月前
|
前端开发
前端毕业设计|基于Vue+Nodejs实现游戏资讯平台(二)
前端毕业设计|基于Vue+Nodejs实现游戏资讯平台
|
4月前
|
JavaScript 前端开发 架构师
阿里前端常考vue面试题汇总(二)
阿里前端常考vue面试题汇总(二)
107 0
|
4天前
|
前端开发 测试技术
前端自动化测试中的快照测试原理
快照测试用于前端自动化测试,通过比较当前应用状态与预存预期快照来检测UI变化。流程包括设置测试环境、捕获屏幕快照、保存预期快照、比较快照及处理差异。当快照比较出现差异时,测试工程师审查判断是否为预期变化或错误,确保应用一致性。这种方法在重构、样式更改和跨浏览器测试时提供有效回归测试,减少手动验证工作。
|
4天前
|
数据采集 监控 前端开发
前端自动化测试
前端自动化测试通过脚本和工具提升开发效率,确保应用在不同环境的品质和一致性。关键方面包括单元测试(如Jest、Mocha)、集成测试(Selenium、Puppeteer)、UI测试、快照测试及持续集成工具(Jenkins、Travis CI)。遵循确定测试范围、编写可维护代码、频繁运行测试和监控结果的最佳实践,可增强代码质量,减少错误。
|
10天前
|
缓存 监控 前端开发
【Flutter前端技术开发专栏】Flutter应用的性能调优与测试
【4月更文挑战第30天】本文探讨了Flutter应用的性能调优策略和测试方法。性能调优对提升用户体验、降低能耗和增强稳定性至关重要。优化布局(避免复杂嵌套,使用`const`构造函数)、管理内存、优化动画、实现懒加载和按需加载,以及利用Flutter的性能工具(如DevTools)都是有效的调优手段。性能测试包括基准测试、性能分析、压力测试和电池效率测试。文中还以ListView为例,展示了如何实践这些优化技巧。持续的性能调优是提升Flutter应用质量的关键。
【Flutter前端技术开发专栏】Flutter应用的性能调优与测试
|
10天前
|
前端开发 测试技术 持续交付
【Flutter 前端技术开发专栏】Flutter 中的 UI 测试与自动化测试
【4月更文挑战第30天】本文探讨了 Flutter 应用中UI测试和自动化测试的重要性,包括保障质量、提高效率和增强开发信心。Flutter提供`flutter_test`库进行Widget测试,以及`flutter_driver`进行集成测试。UI测试涵盖界面布局、交互和状态变化的验证,最佳实践建议尽早引入测试、保持用例简洁,并结合手动测试。未来,随着Flutter技术发展,UI测试和自动化测试将更加完善,助力开发高质量应用。
【Flutter 前端技术开发专栏】Flutter 中的 UI 测试与自动化测试
|
4月前
|
Web App开发 前端开发 JavaScript
Web前端性能测试方法
Web前端性能测试方法
|
4月前
|
Web App开发 前端开发 测试技术
性能测试分层模型以及前端性能测试工具介绍
性能测试分层模型以及前端性能测试工具介绍
|
4月前
|
自然语言处理 JavaScript 前端开发
【前端学习指南】第一站 Vue 生命周期初探
【1月更文挑战第26天】【前端学习指南】第一站 Vue 生命周期初探
|
4月前
|
JavaScript 前端开发 API
Vue.js 3.0新特性解读:开启前端开发新纪元
Vue.js作为前端开发中备受欢迎的框架,近期推出了全新的3.0版本,本文将对Vue.js 3.0的新特性进行深入解读,带领读者探索前端开发的新纪元。