閱讀(1.8k) 書簽贊(0) 我要糾錯(cuò)

Jest 使用匹配器

2021-09-23 20:09 更新

使用匹配器

Jest使用匹配器（Matchers）讓你可以運(yùn)用各種方式測(cè)試你的代碼。這篇文檔將向你介紹一些常用的匹配器，在expect API可以看到完整的列表。

普通匹配器

最簡(jiǎn)單的測(cè)試值的方法是看是否精確匹配。

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

在此代碼中，?expect (2 + 2)? 返回一個(gè)?expect?的對(duì)象。你通常不會(huì)對(duì)這些?expect?對(duì)象調(diào)用過多的匹配器。在此代碼中，?.toBe(4)? 是匹配器。當(dāng) Jest 運(yùn)行時(shí)，它會(huì)跟蹤所有失敗的匹配器，以便它可以為你打印出很好的錯(cuò)誤消息。

?toBe? 使用 ?Object.is ?來(lái)測(cè)試精確相等。如果想要檢查對(duì)象的值，請(qǐng)使用 ?toEqual?代替：

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

?toEqual遞歸檢查對(duì)象或數(shù)組的每個(gè)字段。

你還可以測(cè)試相反的匹配︰

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);
}
}
});

真實(shí)性

在測(cè)試中，有時(shí)候你需要區(qū)分 ?undefined?, ?null?, 和?false?, 但有時(shí)你不想用不同等方式來(lái)對(duì)待它們。Jest 讓你明確你想要什么。

?toBeNull? 只匹配 ?null?
?toBeUndefined ?只匹配 ?undefined?
?toBeDefined ?與 ?toBeUndefined ?相反
?toBeTruthy ?匹配任何 ?if? 語(yǔ)句為真
?toBeFalsy ?匹配任何 ?if ?語(yǔ)句為假

例如：

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();
});

你應(yīng)該用匹配器將你的代碼和你想要的內(nèi)容進(jìn)行最精確的匹配。

數(shù)字

大多數(shù)的比較數(shù)字有等價(jià)的匹配器。

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);
});

對(duì)于比較浮點(diǎn)數(shù)相等，應(yīng)當(dāng)使用 ?toBeCloseTo ?而不是 ?toEqual?，因?yàn)槟悴幌Ｍ麥y(cè)試取決于一個(gè)小小的舍入誤差。

test('兩個(gè)浮點(diǎn)數(shù)字相加',()=>{
const value =0.1+0.2;
//expect(value).toBe(0.3);           這句會(huì)報(bào)錯(cuò)，因?yàn)楦↑c(diǎn)數(shù)有舍入誤差
  expect(value).toBeCloseTo(0.3);// 這句可以運(yùn)行
});

字符串

你可以檢查對(duì)具有 ?toMatch ?正則表達(dá)式的字符串︰

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

數(shù)組和可迭代對(duì)象

你也可以通過 ?toContain?來(lái)檢查一個(gè)數(shù)組或可迭代對(duì)象是否包含某個(gè)特定項(xiàng)：

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');
});

例外

如果要測(cè)試特定函數(shù)在調(diào)用時(shí)是否拋出錯(cuò)誤，請(qǐng)使用?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/);
});