匹配器的使用

    最简单测试一个值的方法是使用精确匹配的方法。

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

    toBe使用 Object.is来进行精准匹配的测试。 If you want to check the value of an object, use toEqual:

    1. test('对象赋值', () => {
    2.   const data = {one: 1};
    3.   data['two'] = 2;
    4.   expect(data).toEqual({one: 1, two: 2});
    5. });

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

    tip

    您还可以使用与匹配相反的 not 来进行测试：

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

    真值

    代码中的undefined, null, and false有不同含义，若你在测试时不想区分他们，可以用真值判断。 Jest提供helpers供你使用。

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

    例如：

    你应该使用最精确匹配的匹配器来测试你期望你的代码能干什么。

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

    1. test('two plus two', () => {
    2.   const value = 2 + 2;
    3.   expect(value).toBeGreaterThan(3);
    4.   expect(value).toBeGreaterThanOrEqual(3.5);
    5.   expect(value).toBeLessThan(5);
    6.   expect(value).toBeLessThanOrEqual(4.5);
    8.   // toBe and toEqual are equivalent for numbers
    9.   expect(value).toBe(4);
    10.   expect(value).toEqual(4);
    11. });
    1. test('两个浮点数字相加', () => {
    2.   const value = 0.1 + 0.2;
    3.   //expect(value).toBe(0.3);           这句会报错，因为浮点数有舍入误差
    4.   expect(value).toBeCloseTo(0.3); // 这句可以运行
    5. });
    6. });

    字符串

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

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

    1. const shoppingList = [
    3.   'kleenex',
    4.   'trash bags',
    5.   'milk',
    6. ];
    8. test('shoppingList数组中包含milk', () => {
    9.   expect(shoppingList).toContain('milk');
    10.   expect(new Set(shoppingList)).toContain('milk');
    11. });

    例外

    若你想测试某函数在调用时是否抛出了错误，你需要使用 toThrow。

    1. function compileAndroidCode() {
    2.   throw new Error('you are using the wrong JDK!');
    3. }
    5. test('compiling android goes as expected', () => {
    6.   expect(() => compileAndroidCode()).toThrow();
    7.   expect(() => compileAndroidCode()).toThrow(Error);
    9.   // You can also use a string that must be contained in the error message or a regexp
    10.   expect(() => compileAndroidCode()).toThrow('you are using the wrong JDK');
    11.   expect(() => compileAndroidCode()).toThrow(/JDK/);
    13.   // Or you can match an exact error message using a regexp like below
    14.   expect(() => compileAndroidCode()).toThrow(/^you are using the wrong JDK$/); // Test fails
    15.   expect(() => compileAndroidCode()).toThrow(/^you are using the wrong JDK!$/); // Test pass

    匹配器的使用 - 图2tip

    The function that throws an exception needs to be invoked within a wrapping function otherwise the toThrow assertion will fail.

    一旦你学会了如何使用匹配器后，接下来可以学习 Jest 是如何让你可以 的。