众所周知,在前面的代码中,我们在编写一个测试用例的时候用到了 test、expect、toBe 三个方法,在之前我们也介绍了 Jest 的基础使用、Jest 的简单配置,今天我们来说说 Jest 中的匹配器(matchers)。
这种语法大概可以翻译为:期待一个值的结果去匹配另一个值。
比如:
expect(1 + 1).toBe(2);
这个例子可以翻译为:期待 1 + 1 的结果是 2,这里的 toBe 就是一个匹配器,用来判断接收值和期望值是否相等。
事实上,在 Jest 中,除了 toBe 之外,还有很多匹配器。
测试两个对象的值是否相等,类似于 js 中的 === 运算符。
// toBe
test("测试加法交换律", () => {
for (let x = 0; x <= 10; x++) {
for (let y = 0; y <= 10; y++) {
expect(x + y).toBe(y + x);
}
}
});
测试两个对象的原始值是否相等,只检查内容,不检查引用。
// toEqual
const can1 = { value: "hello" };
const can2 = { value: "hello" };
test("测试 can1 和 can2 的内容是否相等", () => {
expect(can1).toEqual(can2);
});
测试对象的值是否为null,效果相当于.toBe(null)。
// toBeNull
const value = null;
test("测试值是否为 null", () => {
expect(value).toBeNull();
});
测试对象的值是否为undefined,效果相当于.toBe(undefined)。
// toBeUndefined
const value = undefined;
test("测试值是否为 undefined", () => {
expect(value).toBeUndefined();
});
测试值是否被定义过,除了undefined之外都会通过测试。
// toBeDefined
const value = 1;
test("测试值是否被定义过", () => {
expect(value).toBeDefined();
});
检查值转成布尔值之后是否为真值。
检查值转成布尔值之后是否为假值。
// toBeTruthy、toBeFalsy
test("测试是否为真值", () => {
expect(0).toBeTruthy(); // 不通过
expect("").toBeTruthy(); // 不通过
expect(null).toBeTruthy(); // 不通过
expect(false).toBeTruthy(); // 不通过
expect(undefined).toBeTruthy(); // 不通过
});
test("测试是否为假值", () => {
expect(0).toBeFalsy(); // 通过
expect("").toBeFalsy(); // 通过
expect(null).toBeFalsy(); // 通过
expect(false).toBeFalsy(); // 通过
expect(undefined).toBeFalsy(); // 通过
});
取反匹配器,相当于 js 中的 ! 运算符。
// not
test("测试值是否不为 aaa", () => {
expect("hello").not.toBe("aaa");
});
test("测试值是否不为 null", () => {
expect([]).not.toBeNull();
});
test("测试值是否不为 undefined", () => {
expect({}).not.toBeUndefined();
});
检查接收值是否大于期待值。
// toBeGreaterThan
test("测试 10 是否大于 9", () => {
expect(10).toBeGreaterThan(9);
});
检查接收值是否小于期待值。
// toBeLessThan
test("测试 10 是否小于 20", () => {
expect(10).toBeLessThan(20);
});
toBeGreaterThanOrEqual
检查接收值是否大于等于期待值。
// toBeGreaterThanOrEqual
test("测试 10 是否大于等于 10", () => {
expect(10).toBeGreaterThanOrEqual(10);
});
检查接收值是否小于等于期待值。
// toBeLessThanOrEqual
test("测试 10 是否小于等于 10", () => {
expect(10).toBeLessThanOrEqual(10);
});
检查浮点数是否接近(是否近似相等)。
// toBeCloseTo
test("测试 0.1 + 0.2 是否等于 0.3", () => {
expect(0.1 + 0.2).toBe(0.3); // 不通过
expect(0.1 + 0.2).toBeCloseTo(0.3); //通过
});
检查值是否和字符串或者正则相匹配。
// toMatch
test("测试字符串是否包含 baidu", () => {
expect("www.baidu.com").toMatch("baidu");
expect("www.baidu.com").toMatch(/baidu/);
});
检查数组中是否包含某一项(类似于 js 中的 includes 方法)。
// toContain
test("测试 list 中是否包含 3", () => {
const list = [1, 2, 3];
expect(list).toContain(3);
});
测试函数在调用时是否有异常抛出。
// toThrow
const fn1 = () => {
console.log("hello");
};
const fn2 = () => {
throw new Error("this is a new err");
};
test("测试 fn1、fn2 调用时是否有异常", () => {
expect(fn1).toThrow(); // 不通过
expect(fn2).toThrow(); // 通过
});
在 Jest 中,除了上面这些列举出来的常用的匹配器之外,还有很多匹配器为我们提供。不需要记住所有,知道常用的几个即可。如果想了解更多,可以点击这里查看官方文档。