Jest與Jest Expect擴展

Jest 是一個流行的 JavaScript 測試框架，它可以輕松地添加到任何 JavaScript 項目中。Jest 提供了豐富的 API 來編寫和組織測試用例，同時還提供了強大的斷言功能。

Jest Expect 是 Jest 的斷言庫，它提供了一系列用于驗證測試結果的匹配器（matchers）。這些匹配器可以幫助你檢查函數返回值、對象屬性、數組長度等是否符合預期。

要使用 Jest Expect，首先需要在項目中安裝 Jest：

npm install --save-dev jest

然后，在測試文件中引入 Jest，并使用 expect 函數進行斷言：

const { expect } = require('@jest/globals');

test('adds 1 + 2 to equal 3', () => {
  expect(1 + 2).toBe(3);
});

Jest Expect 提供了許多內置的匹配器，例如：

• toBe：檢查兩個原始值是否相等。
• toEqual：檢查兩個對象是否深度相等。
• toBeTruthy 和 toBeFalsy：檢查值是否為真或假。
• toBeNull 和 toBeUndefined：檢查值是否為 null 或 undefined。
• toBeGreaterThan 和 toBeLessThan：檢查數字是否大于或小于給定值。
• toContain：檢查數組或字符串是否包含特定元素或子字符串。
• toThrow：檢查函數是否拋出錯誤。

此外，你還可以使用自定義匹配器來擴展 Jest Expect 的功能。自定義匹配器是一個返回布爾值的函數，它接受一個或多個參數，并根據這些參數的值判斷測試是否通過。要創建自定義匹配器，可以使用 expect.extend 方法：

expect.extend({
  toBeWithinRange(received, floor, ceiling) {
    const pass = received >= floor && received <= ceiling;
    if (pass) {
      return {
        message: () => `expected ${received} not to be within range ${floor} - ${ceiling}`,
        pass: true,
      };
    } else {
      return {
        message: () => `expected ${received} to be within range ${floor} - ${ceiling}`,
        pass: false,
      };
    }
  },
});

test('value is within range', () => {
  expect(5).toBeWithinRange(1, 10);
});

在上面的示例中，我們創建了一個名為 toBeWithinRange 的自定義匹配器，用于檢查一個值是否在指定范圍內。然后，在測試用例中使用這個匹配器來驗證測試結果。