测试不仅可以发现和预防问题,还能降低风险、减少企业损失。在React中,涌现了多种测试框架,本节会对其中的Jest和Enzyme做详细的讲解。

一、Jest

  Jest是由Facebook开源的一个测试框架,可无缝兼容React项目,专注简单,推崇零配置,开箱即用的宗旨,用于逻辑和组件的单元测试。它的语法和断言与Jasmine类似,并且还集成了快照测试、Mock、覆盖率报告等功能,支持多进程并行运行测试,在内部使用JSDOM操作DOM,JSDOM是一种模拟的DOM环境,其行为类似于常规浏览器,可用来与用户交互、在节点上派发事件等。

1)运行

  为了便于运行Jest,本文使用Create React App创建项目,命令如下所示。

npx create-react-app my-app

  只要把测试文件放置在__tests__目录内,或将它们的名称添加.test.js或.spec.js后缀,并保存在项目的src目录中的任何深度,就能被Jest检测到。当运行下面的命令时,可得到相关的测试结果。

npm test

  默认情况下,Jest每次只运行与本次更改的文件相关的测试用例。

2)创建测试

  如果要创建测试用例(Test Case),那么需要使用test()或it()函数,其第一个参数是测试名称,第二个参数是包含测试代码的回调函数,如下所示。

test("two plus two is four", () => {
expect(2 + 2).toBe(4);
});

  expect()函数用于断言,它能接收一个实际值,并将其作为结果与匹配器中的期望值做比较。如果匹配失败,那么就会在控制台输出相应的错误提示。

  describe()函数可将测试用例进行逻辑分组,其第一个参数可定义分组的名称,如下所示。

describe("my test case", () => {
test("one plus one is two", () => {
expect(1 + 1).toBe(2);
});
test("two plus two is four", () => {
expect(2 + 2).toBe(4);
});
});

3)匹配器

  通过匹配器(Matcher)可以各种方式来测试代码,例如之前示例中的toBe()就是一个匹配器,它使用Object.is()来测试精确匹配,如果要检查对象是否相等,可改用toEqual(),如下所示。

test("object assignment", () => {
const data = { name: "strick" };
data["age"] = 28;
expect(data).toEqual({ name: "strick", age: 28 });
});

  其它常用的匹配器还有区分undefined、null和布尔值、比较数字、匹配字符串、检查数组或可迭代对象是否包含某个特定项、测试抛出的错误等功能。

  所有的匹配器都可以通过.not取反,例如验证toBeUndefined()不能匹配null,如下所示。

test("null is not undefined", () => {
expect(null).not.toBeUndefined();
});

4)异步测试

  Jest提供了多种方式来测试异步代码,包括回调函数、Promise和Async/Await,接下来会逐个讲解用法。

  (1)默认情况下,Jest测试一旦执行到末尾就会完成,例如有一个check()函数(如下所示),它能接收一个回调函数,一旦check()执行结束,此测试就会在没有执行回调函数前结束。

function check(func) {
const success = true;
func(success);
}
test("the data is truth", () => {
function callback(data) {
expect(data).toBeTruthy();
}
check(callback);
});

  若要解决此问题,可为test()的回调函数传递一个名为done的函数参数,Jest会等done()回调函数执行完后,再结束测试,如下所示。

test("the data is truth", done => {
function callback(data) {
expect(data).toBeTruthy();
done();
}
check(callback);
});

  (2)当异步代码返回Promise对象时,Jest会等待其状态的变化。如果状态变为已完成,那么得使用then()方法;如果状态变为已拒绝,那么得使用catch()方法,如下所示。

//状态为已完成
function checkResolve() {
return new Promise((resolve, reject) => {
resolve(true);
});
}
test("the data is truth", () => {
return checkResolve().then(data => {
expect(data).toBeTruthy();
});
});
//状态为已拒绝
function checkReject() {
return new Promise((resolve, reject) => {
reject(false);
});
}
test("the data is falsity", () => {
return checkReject().catch(data => {
expect(data).toBeFalsy();
});
});

  注意,要将Promise对象作为test()的回调函数的返回值,以免测试提前完成,导致没有进行方法链中的断言。

  在expect语句中也可以使用.resolves或.rejects两种匹配器来处理Promise的两种状态,如下所示,语法更为简洁。

test("the data is truth", () => {
expect(checkResolve()).resolves.toBeTruthy();
});
test("the data is falsity", () => {
expect(checkReject()).rejects.toBeFalsy();
});

  (3)在测试中使用async和await两个关键字,也可以匹配Promise对象,例如断言checkResolve()的处理结果,如下所示。

test("the data is truth", async () => {
const data = await checkResolve();
expect(data).toBeTruthy();
});

  它们也能用来测试已拒绝状态的Promise,如下所示,其中assertions()用于验证在测试中是否执行了指定数量的断言。

function checkError() {
return new Promise((resolve, reject) => {
reject();
}).catch(() => {
throw "error";
});
}
test("the check fails with an error", async () => {
expect.assertions(1);
try {
await checkError();
} catch (e) {
expect(e).toMatch("error");
}
});

  aysnc和awiat还可以与.resolves或.rejects结合使用,如下所示。

test("the data is truth", async () => {
await expect(checkResolve()).resolves.toBeTruthy();
});
test("the check fails with an error", async () => {
await expect(checkError()).rejects.toMatch("error");
});

5)辅助函数

  有时候,在运行测试前需要做些准备工作,而在运行测试之后又需要做些整理工作,Jest提供了四个相关的辅助函数来处理这两类工作,如下所列。

  (1)beforeAll()和afterAll()会在所有测试用例之前和之后执行一次。

  (2)beforeEach()和afterEach()会在每个测试用例之前和之后执行,并且可以像异步测试那样处理异步代码。

  假设在四个辅助函数中输出各自的函数名称,并且有两个测试用例,如下代码所示。

beforeAll(() => {
console.log("beforeAll");
});
afterAll(() => {
console.log("afterAll");
});
beforeEach(() => {
console.log("beforeEach");
});
afterEach(() => {
console.log("afterEach");
}); test("first", () => {
expect(2).toBeGreaterThan(1);
});
test("second", () => {
expect(2).toBeLessThan(3);
});

  每次运行测试,在控制台将依次打印出“beforeAll”,两对“beforeEach”和“afterEach”,“afterAll”。

  当通过describe()对测试用例进行分组时(如下所示),外部的beforeEach()和afterEach()会优先执行。

describe("scoped", () => {
beforeEach(() => console.log("inner beforeEach"));
afterEach(() => console.log("inner afterEach"));
test("third", () => {
expect([1, 2]).toContain(1);
});
});

6)Mock

  Jest内置了Mock函数,可用于擦除函数的实际实现来测试代码之间的连接,捕获函数的调用和参数、配置其返回值等。

  假设要测试一个自定义的forEach()函数的内部实现,那么可以使用jest.fn()创建一个Mock函数,然后通过检查它的mock属性来确保回调函数是否在按预期调用,如下所示。

function forEach(items, callback) {
for (let index = 0; index < items.length; index++) {
callback(items[index]);
}
}
test("forEach", () => {
const mockFunc = jest.fn(x => 42 + x);
forEach([0, 1], mockFunc);
expect(mockFunc.mock.calls.length).toBe(2); //此Mock函数被调用了两次
expect(mockFunc.mock.calls[0][0]).toBe(0); //第一次调用函数时的第一个参数是0
expect(mockFunc.mock.calls[1][0]).toBe(1); //第二次调用函数时的第一个参数是1
expect(mockFunc.mock.results[0].value).toBe(42); //第一次函数调用的返回值是42
});

  每个Mock函数都会包含一个特殊的mock属性,记录了函数如何被调用、调用时的返回值等信息,通过该属性还能追踪每次调用时的this的值。如果要用Mock函数注入返回值,那么可以像下面这样链式的添加,首次调用返回10,第二次调用返回“x”,接下来的调用都返回true。其中mockName()方法可为Mock函数命名,该名称将在输出的日志中显示,可替换掉默认的“jest.fn()”。

const myMock = jest.fn().mockName("returnValue");
myMock
.mockReturnValueOnce(10)
.mockReturnValueOnce("x")
.mockReturnValue(true);
console.log(myMock(), myMock(), myMock(), myMock()); //10, 'x', true, true

  Mock函数还可以模拟模块,例如拦截axios请求得到的数据,如下代码所示,为.get提供了一个mockResolvedValue()方法,它会返回用于测试的假数据。

import axios from "axios";
jest.mock("axios");
class Users {
static all() {
return axios.get("./users.json").then(resp => resp.data);
}
}
test("should fetch users", () => {
const users = [{ name: "strick" }];
const resp = { data: users };
axios.get.mockResolvedValue(resp);
return Users.all().then(data => expect(data).toEqual(users));
});

  原生的定时器函数测试起来并不方便,通过jest.useFakeTimers()可以模拟定时器函数,如下所示。

function timerGame() {
setTimeout(() => {
console.log("start");
}, 1000);
}
jest.useFakeTimers();
test("setTimeout", () => {
timerGame();
expect(setTimeout).toHaveBeenCalledTimes(1);        //调用了1次
expect(setTimeout).toHaveBeenLastCalledWith(expect.any(Function), 1000); //1秒后执行回调
});

  Jest模拟出的定时器函数还有快进到正确的时间点、执行当前正在等待的定时器等功能。

7)快照测试

  Jest提供的快照测试(Spapshot Testing)是一种高效的UI测试,它会将React组件序列化成纯文本(即快照)并保存在硬盘中,每次测试就把当前生成的快照与保存的快照进行对比,接下来用一个例子来介绍快照测试的用法。

  首先创建一个Link组件,它会渲染出一条包含onMouseEnter事件的链接,当鼠标移动到这条链接时,会改变它的class属性。

import React from "react";
const STATUS = {
HOVERED: "hovered",
NORMAL: "normal"
};
export default class Link extends React.Component {
constructor(props) {
super(props);
this._onMouseEnter = this._onMouseEnter.bind(this);
this.state = {
class: STATUS.NORMAL
};
}
_onMouseEnter() {
this.setState({ class: STATUS.HOVERED });
}
render() {
return (
<a
href="#"
className={this.state.class}
onMouseEnter={this._onMouseEnter}
>
{this.props.children}
</a>
);
}
}

  然后创建测试文件spapshot.test.js,在其内部,除了要引入Link组件之外,还得引入react-test-renderer,它不依赖浏览器和JSDOM,可将React组件渲染成JavaScript对象(即快照)。

import React from "react";
import Link from "./Link";
import renderer from "react-test-renderer"; test("Link changes the class when hovered", () => {
const component = renderer.create(<Link>Strick</Link>);
let tree = component.toJSON();
expect(tree).toMatchSnapshot(); tree.props.onMouseEnter(); //触发事件
tree = component.toJSON(); //重新渲染
expect(tree).toMatchSnapshot();
});

  在第一次运行测试时,会自动创建__snapshots__目录,放置对应的快照文件spapshot.test.js.snap,其内容如下所示,包含两张快照,第二张是触发onMouseEnter事件后生成的。

exports[`Link changes the class when hovered 1`] = `
<a
className="normal"
href="#"
onMouseEnter={[Function]}
>
Strick
</a>
`; exports[`Link changes the class when hovered 2`] = `
<a
className="hovered"
href="#"
onMouseEnter={[Function]}
>
Strick
</a>
`;

  如果要刷新保存的快照,除了手动删除之外,还可以通过jest -u命令实现。

二、Enzyme

  Enzyme是一款用于React组件的测试框架,可处理渲染出的DOM结构,开放的API类似于jQuery的语法,提供了三种不同的方式来测试组件:浅层渲染(Shallow Rendering)、完全渲染(Full Rendering)和静态渲染(Static Rendering)。从Enzyme 3开始,在安装Enzyme的同时,还需要安装与React版本相对应的适配器,命令如下所示。

npm install --save enzyme enzyme-adapter-react-16

1)浅层渲染

  独立于DOM的浅层渲染只会渲染React组件的第一层,它会忽略子组件的行为,也就没必要渲染子组件了,这提供了更好的隔离性。不过浅层渲染也有它局限性,即不支持Refs。

  以上一节中的Link组件为例,在进行Enzyme之前,需要先通过configure()函数配置适配器,然后才能通过shallow()函数浅渲染Link组件,如下所示。

import React from "react";
import { shallow, configure } from "enzyme";
import Adapter from "enzyme-adapter-react-16";
import Link from "../component/Form/Link"; configure({ adapter: new Adapter() });
test("Link changes the class after mouseenter", () => {
const wrapper = shallow(<Link>Strick</Link>),
a = wrapper.find("a");
expect(wrapper.text()).toEqual("Strick");
a.simulate("mouseenter");     //触发事件
expect(a.prop("className")).toEqual("normal"); //匹配样式
});

  wrapper是一个虚拟的DOM对象,它包含多个操作DOM的方法,例如find()可根据选择器找到指定的节点,simulate()可触发当前节点的事件。

2)完全渲染

  mount()函数会完全渲染接收的组件,即它的子组件也会被渲染。完全渲染依赖JSDOM,当多个测试处理同一个DOM时,可能会相互影响,因此在测试结束后需要使用unmount()方法卸载组件。

3)静态渲染

  render()函数会静态渲染组件,也就是将它渲染成HTML字符串,再通过Cheerio库解析该HTML结构。Cheerio类似于JSDOM,但更轻量,可像jQuery那样操作字符串。

React躬行记(14)——测试框架的更多相关文章

  1. React躬行记(5)——React和DOM

    React实现了一套与浏览器无关的DOM系统,包括元素渲染.节点查询.事件处理等机制. 一.ReactDOM 自React v0.14开始,官方将与DOM相关的操作从React中剥离,组成单独的rea ...

  2. React躬行记(8)——样式

    由于React推崇组件模式,因此会要求HTML.CSS和JavaScript混合在一起,虽然这与过去的关注点分离正好相反,但是更有利于组件之间的隔离.React已将HTML用JSX封装,而对CSS只进 ...

  3. React躬行记(3)——组件

    组件(Component)由若干个React元素组成,包含属性.状态和生命周期等部分,满足独立.可复用.高内聚和低耦合等设计原则,每个React应用程序都是由一个个的组件搭建而成,即组成React应用 ...

  4. React躬行记(15)——React Hooks

    Hook(钩子)是React v16.8新引入的特性,能以钩子的形式为函数组件附加类组件的状态.生命周期等特性.React的类组件有难以拆分.测试,状态逻辑分散,难以复用等问题,虽然可以通过渲染属性( ...

  5. React躬行记(1)——函数式编程

    函数式编程是React的精髓,在正式讲解React之前,有必要先了解一下函数式编程,有助于更好的理解React的特点.函数式编程(Functional Programming)不是一种新的框架或工具, ...

  6. React躬行记(16)——React源码分析

    React可大致分为三部分:Core.Reconciler和Renderer,在阅读源码之前,首先需要搭建测试环境,为了方便起见,本文直接采用了网友搭建好的环境,React版本是16.8.6,与最新版 ...

  7. React躬行记(2)——JSX

    JSX既不是字符串,也不是HTML,而是一种类似XML,用于描述用户界面的JavaScript扩展语法,如下代码所示.在使用JSX时,为了避免自动插入分号时出现问题,推荐在其最外层用圆括号包裹,并且必 ...

  8. React躬行记(4)——生命周期

    组件的生命周期(Life Cycle)包含三个阶段:挂载(Mounting).更新(Updating)和卸载(Unmounting),在每个阶段都会有相应的回调方法(也叫钩子)可供选择,从而能更好的控 ...

  9. React躬行记(6)——事件

    React在原生事件的基础上,重新设计了一套跨浏览器的合成事件(SyntheticEvent),在事件传播.注册方式.事件对象等多个方面都做了特别的处理. 一.注册事件 合成事件采用声明式的注册方式, ...

随机推荐

  1. Spring Boot 快速入门 史上最简单

    1.Spring Boot 概述 Spring Boot 是所有基于 Spring 开发的项目的起点.Spring Boot 的设计是为了让你尽可能快的跑起来 Spring 应用程序并且尽可能减少你的 ...

  2. Nexus 上传项目到私服

    1. maven setting配置 <?xml version="1.0" encoding="UTF-8"?> <!-- Licensed ...

  3. 11 一步一步Zabbix4.4.0系统教你实现sendEmail邮件报警

    点击返回:自学Zabbix之路 点击返回:自学Zabbix4.0之路 点击返回:自学zabbix集锦 一步一步Zabbix4.4.0系统教你实现sendEmail邮件报警 sendEmail是一个轻量 ...

  4. javaScipt类定义和实现

      最近在几个群上经常看到有人问在一个类里的一个 function 怎么调用 this. 定义后公开的方法.现发一篇类实现的随笔.首先说说类,在一个类里我们会有以下的几个特征:1. 公有方法2. 私有 ...

  5. python学习之【第十二篇】:Python中的迭代器

    1.为何要有迭代器? 对于序列类型:字符串.列表.元组,我们可以使用索引的方式迭代取出其包含的元素.但对于字典.集合.文件等类型是没有索引的,若还想取出其内部包含的元素,则必须找出一种不依赖于索引的迭 ...

  6. day 2 上午 挂饰 背包

    #include<iostream> #include<algorithm> #include<cstring> #include<cstdio> us ...

  7. 卖饲料——单调队列优化dp

    题目描述 约翰开车来到镇上,他要带K吨饲料回家.运送饲料是需要花钱的,如果他的车上有X吨饲料,每公里就要花费X^2元,开车D公里就需要D* X^2元.约翰可以从N家商店购买饲料,所有商店都在一个坐标轴 ...

  8. 爬虫学习--Day4(小猿圈爬虫开发_2)

    requests模块 - urllib模块 - requests模块 requests模块:python中原生的一款基于网络请求的模块,功能非常强大,简单便捷,效率极高.作用:模拟浏览器发送请求. 如 ...

  9. nginx recv() failed (104: Connection reset by peer) while reading response header from upstream解决方法

    首先说下 先看 按照ab 每秒请求的结果 看看 都有每秒能请求几个 如果并发量超出你请求的个数 会这样 所以一般图片和代码服务器最好分开 还有看看io瓶ding 和有没有延迟的PHP代码执行 0 先修 ...

  10. 护网杯web

    首先进入网页后,观察到有sign up 点击sign up 进行注册 再点击sign in 进行登录 进入一个买辣条的界面,可以知道,5元可以买一包大辣条,多包大辣条可以换一包辣条之王,多包辣条之王可 ...