Mocha+Koa技术问题：如何Mock KoaContext对象？

不用逐一定义KoaContext的全部属性，有几种简单方法可以Mock上下文并通过TypeScript检查：

• 方法1：用类型断言跳过属性检查
  直接将空对象断言为KoaContext，让TypeScript暂时忽略属性缺失的报错，同时补充函数实际需要的属性即可：

it('should handle an empty query string', function () {
    // 用as断言跳过TS的完整属性校验
    const ctx = {} as KoaContext;
    // 仅补充q2m函数依赖的属性
    ctx.request = { query: {} };

    const result = q2m(ctx, {});

    const expectation: Q2mMongoQuery = {
      rawQuery: ctx.request.query,
      filters: {},
      page: 1,
      limit: 25,
      skip: 0,
      search: null,
      sortField: null,
      sortDirection: 'ASC',
    };

    assert.deepEqual(result, expectation);
});

• 方法2：利用Partial类型定义最小化Mock
  通过Partial<KoaContext>生成所有属性为可选的类型，只定义测试需要的部分，再断言为原类型：

it('should handle an empty query string', function () {
    // 仅声明函数用到的属性结构
    const partialCtx: Partial<KoaContext> = {
      request: { query: {} }
    };
    // 转换为KoaContext类型
    const ctx = partialCtx as KoaContext;

    const result = q2m(ctx, {});

    const expectation: Q2mMongoQuery = {
      rawQuery: ctx.request.query,
      filters: {},
      page: 1,
      limit: 25,
      skip: 0,
      search: null,
      sortField: null,
      sortDirection: 'ASC',
    };

    assert.deepEqual(result, expectation);
});

• 方法3：仅Mock函数实际依赖的属性
  如果q2m只用到ctx.request.query这类特定属性，直接构造对应结构并断言即可，不用管其他未用到的属性：

it('should handle an empty query string', function () {
    // 仅提供函数运行必需的属性
    const ctx = {
      request: { query: {} }
    } as KoaContext;

    const result = q2m(ctx, {});

    const expectation: Q2mMongoQuery = {
      rawQuery: ctx.request.query,
      filters: {},
      page: 1,
      limit: 25,
      skip: 0,
      search: null,
      sortField: null,
      sortDirection: 'ASC',
    };

    assert.deepEqual(result, expectation);
});

这些方法的核心逻辑是：单元测试只需要覆盖函数实际用到的属性，不需要模拟完整的KoaContext对象，通过类型断言或Partial类型可以快速绕过TypeScript的严格校验。

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