Jest 使用匹配器

使用匹配器

Jest使用匹配器（Matchers）让你可以运用各种方式测试你的代码。 这篇文档将向你介绍一些常用的匹配器， 在expect API可以看到完整的列表。

普通匹配器

最简单的测试值的方法是看是否精确匹配。

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

在此代码中，​expect (2 + 2)​ 返回一个​expect​的对象。 你通常不会对这些​expect​对象调用过多的匹配器。 在此代码中，​.toBe(4)​ 是匹配器。 当 Jest 运行时，它会跟踪所有失败的匹配器，以便它可以为你打印出很好的错误消息。

​toBe​ 使用 ​Object.is ​来测试精确相等。 如果想要检查对象的值，请使用 ​toEqual​代替：

test('object assignment',()=>{
const data ={one:1};
  data['two']=2;
  expect(data).toEqual({one:1, two:2});
});

​toEqual递归检查对象或数组的每个字段。

你还可以测试相反的匹配︰

test('adding positive numbers is not zero',()=>{
for(let a =1; a <10; a++){
for(let b =1; b <10; b++){
      expect(a + b).not.toBe(0);
}
}
});

真实性

在测试中，有时候你需要区分 ​undefined​, ​null​, 和​false​, 但有时你不想用不同等方式来对待它们。Jest 让你明确你想要什么。

• ​toBeNull​ 只匹配 ​null​
• ​toBeUndefined ​只匹配 ​undefined​
• ​toBeDefined ​与 ​toBeUndefined ​相反
• ​toBeTruthy ​匹配任何 ​if​ 语句为真
• ​toBeFalsy ​匹配任何 ​if ​语句为假

例如：

test('null',()=>{
const n =null;
  expect(n).toBeNull();
  expect(n).toBeDefined();
  expect(n).not.toBeUndefined();
  expect(n).not.toBeTruthy();
  expect(n).toBeFalsy();
});
test('zero',()=>{
const z =0;
  expect(z).not.toBeNull();
  expect(z).toBeDefined();
  expect(z).not.toBeUndefined();
  expect(z).not.toBeTruthy();
  expect(z).toBeFalsy();
});

你应该用匹配器将你的代码和你想要的内容进行最精确的匹配。

数字

大多数的比较数字有等价的匹配器。

test('two plus two',()=>{
const value =2+2;
  expect(value).toBeGreaterThan(3);
  expect(value).toBeGreaterThanOrEqual(3.5);
  expect(value).toBeLessThan(5);
  expect(value).toBeLessThanOrEqual(4.5);
// toBe and toEqual are equivalent for numbers
  expect(value).toBe(4);
  expect(value).toEqual(4);
});

对于比较浮点数相等，应当使用 ​toBeCloseTo ​而不是 ​toEqual​，因为你不希望测试取决于一个小小的舍入误差。

test('两个浮点数字相加',()=>{
const value =0.1+0.2;
//expect(value).toBe(0.3);           这句会报错，因为浮点数有舍入误差
  expect(value).toBeCloseTo(0.3);// 这句可以运行
});

字符串

你可以检查对具有 ​toMatch ​正则表达式的字符串︰

test('there is no I in team',()=>{
  expect('team').not.toMatch(/I/);
});
test('but there is a "stop" in Christoph',()=>{
  expect('Christoph').toMatch(/stop/);
});

数组和可迭代对象

你也可以通过 ​toContain​来检查一个数组或可迭代对象是否包含某个特定项：

const shoppingList =[
'diapers',
'kleenex',
'trash bags',
'paper towels',
'beer',
];
test('the shopping list has beer on it',()=>{
  expect(shoppingList).toContain('beer');
  expect(newSet(shoppingList)).toContain('beer');
});

例外

如果要测试特定函数在调用时是否抛出错误，请使用​toThrow​.

function compileAndroidCode(){
thrownewError('you are using the wrong JDK');
}
test('compiling android goes as expected',()=>{
  expect(compileAndroidCode).toThrow();
  expect(compileAndroidCode).toThrow(Error);
// You can also use the exact error message or a regexp
  expect(compileAndroidCode).toThrow('you are using the wrong JDK');
  expect(compileAndroidCode).toThrow(/JDK/);
});

更多内容

以上这些内容只是浅尝辄止，想要了解更多有关匹配器的完整列表，请查阅参考文档。

一旦你学会了如何使用匹配器后，接下来可以学习 Jest 是如何测试异步代码的。