TypeScript中Pact V3如何直接比对完整响应与Matcher示例值？

问题根源很明确：Pact V3的string()、number()这类匹配器返回的是包含匹配规则元数据的对象（比如带pact:matcher:type字段），而不是你传入的示例值本身。直接用toStrictEqual比对，自然会因为结构不一致失败。

下面是几种可行的解决方法：

方法1：用Pact内置的getExample提取示例值 #

Pact官方提供了getExample工具函数，可以递归遍历包含匹配器的对象，提取出所有字段的示例值，生成一个普通的JS对象，这样就能直接和API响应比对了。

import { getExample } from '@pact-foundation/pact';

// 你的匹配器对象定义
const userExample = {
  id: number(123),
  email: string('user@example.com'),
  username: string('johndoe')
};

// 转换为纯示例值对象
const userExamplePlain = getExample(userExample);

// 直接比对响应数据
expect(response.data).toStrictEqual(userExamplePlain);

这个方法最省心，能处理所有Pact支持的匹配器类型（包括嵌套对象、数组、正则匹配等），优先推荐。

方法2：用Pact断言验证匹配规则 #

如果你的需求不是严格比对示例值，而是验证响应数据符合匹配器定义的规则（比如id必须是数字、email必须是字符串），可以用Pact的断言工具来直接校验：

import { matchers } from '@pact-foundation/pact';

// 验证响应数据符合匹配器的规则定义
expect(response.data).toMatchObject(matchers.extractPayload(userExample));

这种方式不需要依赖示例值，而是直接校验数据类型、格式是否符合匹配器的要求，适合更灵活的场景。

方法3：手动封装提取函数（备用方案） #

如果因为版本兼容问题无法使用getExample，可以自己写一个递归函数来提取每个匹配器的.value：

function extractMatcherValues(obj: any): any {
  if (obj === null || typeof obj !== 'object') {
    return obj;
  }
  // 处理Pact匹配器对象
  if ('value' in obj) {
    return extractMatcherValues(obj.value);
  }
  // 处理数组
  if (Array.isArray(obj)) {
    return obj.map(item => extractMatcherValues(item));
  }
  // 处理普通对象
  const result: Record<string, any> = {};
  for (const key in obj) {
    result[key] = extractMatcherValues(obj[key]);
  }
  return result;
}

// 使用示例
const userExamplePlain = extractMatcherValues(userExample);
expect(response.data).toStrictEqual(userExamplePlain);

注意：手动函数可能无法覆盖所有Pact匹配器的边缘情况（比如复杂的组合匹配器），所以优先用官方工具。

内容的提问来源于stack exchange，提问作者Donald C.