使用错误消息扩展JASMINE匹配器

在使用 Jasmine 进行单元测试时，有时会遇到需要自定义错误消息的情况，以便更清晰地了解测试失败的原因。Jasmine 允许通过扩展匹配器（Matchers）来实现这一点。以下是一些基础概念和相关信息：

基础概念

Jasmine Matchers：Jasmine 提供了一组内置的匹配器，如 toBe、toEqual、toContain 等，用于断言测试结果。

自定义匹配器：开发者可以创建自己的匹配器，以满足特定需求或提供更详细的错误信息。

扩展 Jasmine 匹配器的优势

提高可读性：自定义错误消息可以使测试失败时的输出更加直观易懂。
灵活性：可以根据具体需求定制匹配逻辑和错误信息。
复用性：自定义匹配器可以在多个测试中重复使用。

类型与应用场景

类型：自定义匹配器可以是简单的布尔检查，也可以是复杂的逻辑判断。
应用场景：适用于任何需要特定断言逻辑的场景，如复杂对象的深度比较、特定格式的字符串验证等。

示例代码

以下是如何扩展 Jasmine 匹配器并添加自定义错误消息的示例：

// 自定义匹配器
beforeEach(() => {
  jasmine.addMatchers({
    toBeWithinRange: () => {
      return {
        compare: (actual, expectedMin, expectedMax) => {
          const result = {
            pass: actual >= expectedMin && actual <= expectedMax,
            message: () => `Expected ${actual} to be within range [${expectedMin}, ${expectedMax}]`
          };
          return result;
        }
      };
    }
  });
});

// 使用自定义匹配器
describe('Custom Matcher Example', () => {
  it('should pass if number is within range', () => {
    expect(5).toBeWithinRange(1, 10);
  });

  it('should fail with custom message if number is out of range', () => {
    expect(15).toBeWithinRange(1, 10);
  });
});