如何在Express+TypeScript+Mocha中正确Mock Request对象？

问题原因 #

你遇到的TypeScript错误，是因为手动Mock的req对象仅实现了get方法，和Express完整的Request类型结构差异过大，直接类型转换被TS判定为不安全操作。

可选解决方案 #

强制转换为unknown再转Request是可行方案之一，但并非唯一选择，以下是几种更优雅的处理方式：

1. 先转unknown再转Request（快速解决） #

按照TS提示的方式，先将对象转为unknown（TS对unknown的转换限制最少），再转为Request：

describe("Authorization middleware", () => {
  it("Fails when no authorization header", () => {
    const req = {
      get: () => null,
    };
    expect(isAuth(req as unknown as Request, {}, () => {}));
  });
});

2. 使用Partial定义Mock对象 #

利用TS的Partial工具类型，让Request的所有属性变为可选，这样只实现需要的get方法即可，类型检查更友好：

describe("Authorization middleware", () => {
  it("Fails when no authorization header", () => {
    const req: Partial<Request> = {
      get: () => null,
    };
    expect(isAuth(req as Request, {}, () => {}));
  });
});

3. 使用专门的Mock库（推荐） #

用成熟的Mock库直接生成符合Request类型的对象，无需手动处理类型转换，比如mock-req-res：

import { createRequest } from 'mock-req-res';

describe("Authorization middleware", () => {
  it("Fails when no authorization header", () => {
    const req = createRequest();
    req.get = () => null;
    expect(isAuth(req, {}, () => {}));
  });
});

这类库生成的对象本身就是Request类型，直接修改需要的属性/方法即可，完全避免类型转换问题。

4. 用Pick提取需要的类型 #

如果只需要Request的特定属性，可以用Pick工具类型定义精确的Mock类型，减少类型转换的风险：

type MockAuthReq = Pick<Request, 'get'>;

describe("Authorization middleware", () => {
  it("Fails when no authorization header", () => {
    const req: MockAuthReq = {
      get: () => null,
    };
    expect(isAuth(req as Request, {}, () => {}));
  });
});

总结 #

强制转unknown是快速解决方式，但使用Partial类型或专门的Mock库能让代码更具可读性和类型安全性，根据项目需求选择即可。

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