如何使用TypeScript Partial类型测试AWS Lambda函数？

Partial<T>的核心作用是将传入类型的所有属性设为可选，也就是说每个属性的类型都会自动追加undefined的联合类型，你遇到的报错有两个层面的原因：

1. body属性层面：原始APIGatewayProxyEvent的body类型是string | null，经过Partial修饰后变成string | null | undefined，不符合原始类型的要求。
2. 其他属性层面：即使你手动给body赋了合法的字符串值，APIGatewayProxyEvent还有headers、httpMethod、path等大量必填属性，Partial修饰后这些属性都变成了可能为undefined的状态，依然不符合原始类型的要求。
   你之前尝试的Omit+Pick组合只修复了body字段的可选状态，其他必填属性（比如headers）依然是可选的，所以还是会触发类型报错。

方案1：封装模拟事件的工具函数（兼顾语义和便捷性） #

你不想直接用as做类型断言，本质是不想让测试代码的语义模糊。我们可以把类型断言封装到语义明确的工具函数里，既保留Partial的写法，也让同事一眼能看懂这是测试用的模拟对象：

// 全局复用的测试工具函数
function mockAPIGatewayEvent(partial: Partial<APIGatewayProxyEvent>): APIGatewayProxyEvent {
  return partial as APIGatewayProxyEvent;
}

it("should return 400 when request event is invalid", async () => {
  const invalidEvent = mockAPIGatewayEvent({
    body: JSON.stringify({ foo: "bar" }),
  });
  const { statusCode } = await handler(invalidEvent);
  expect(statusCode).toBe(400);
});

这种方案适合你明确知道handler在当前测试场景下只会用到你传入的属性，不会读取其他未定义的属性。

方案2：复用基础Mock事件（无类型断言，完全类型安全） #

如果你不想用任何类型断言，可以预先定义一个通用的合法基础事件，所有测试用例都在基础事件上覆盖需要修改的字段即可，不会在单测里出现冗余字段：

// 全局定义一次即可，所有APIGateway测试都可以复用
const baseMockEvent: APIGatewayProxyEvent = {
  body: null,
  headers: {},
  multiValueHeaders: {},
  httpMethod: 'POST',
  isBase64Encoded: false,
  path: '/test',
  pathParameters: null,
  queryStringParameters: null,
  multiValueQueryStringParameters: null,
  stageVariables: null,
  requestContext: {} as any,
  resource: ''
};

it("should return 400 when request event is invalid", async () => {
  // 仅覆盖测试需要修改的body字段，其他字段复用默认值
  const invalidEvent = {
    ...baseMockEvent,
    body: JSON.stringify({ foo: "bar" }),
  };
  const { statusCode } = await handler(invalidEvent);
  expect(statusCode).toBe(400);
});

方案3：缩小handler参数类型（符合类型设计规范） #

如果你的handler实际运行中只会用到event的少数几个属性，可以直接调整handler的参数类型，用Pick声明实际依赖的属性，从根源上避免需要传入完整事件的问题：

// 比如handler仅用到body和headers两个属性
async function handler(event: Pick<APIGatewayProxyEvent, 'body' | 'headers'>) {
  // 原有逻辑不变
}

// 测试时只需要传入用到的属性即可，不会有类型报错
it("should return 400 when request event is invalid", async () => {
  const invalidEvent = {
    body: JSON.stringify({ foo: "bar" }),
    headers: {}
  };
  const { statusCode } = await handler(invalidEvent);
  expect(statusCode).toBe(400);
});

内容的提问来源于stack exchange，提问作者mikemaccana