TypeScript中如何对类方法单元测试且不发起真实API请求

现有测试写法的问题 #

你当前对getInclusiveData方法本身做spy的写法完全无效：

• spy的作用是观测被测代码和外部依赖的交互逻辑，把被测方法本身作为监听目标，只能证明你手动调用过该方法，完全覆盖不到内部请求、解析、赋值的核心业务逻辑。
• 这个场景下唯一的外部I/O依赖是全局fetch API，所有真实网络请求都是它发起的，只要把它替换为测试桩，就能完全隔离真实服务调用，不需要依赖任何第三方mock服务。

可直接落地的测试点 #

不需要发起真实API调用，你可以覆盖以下核心逻辑：

• 调用方法时是否向正确的接口地址发起请求
• 请求的method、headers配置是否符合预设的HEADER_INFO规则
• 接口返回正常结构时，是否正确解析响应体中的results字段
• 解析完成后是否正确给实例私有属性_names赋值
• 方法最终返回值是否和接口返回的results一致
• 请求报错、响应结构异常时，方法是否正确透传/处理错误
• （额外逻辑校验）你当前实现里传入的name参数、构造函数接收的_accessToken/_environment参数均未在请求逻辑中使用，属于明显的逻辑遗漏，可以通过测试发现这类问题。

具体实现代码（基于sinon + 任意JS测试框架，Mocha/Jest通用） #

核心思路是：每次测试前替换全局fetch为可控桩对象，测试完成后还原原生fetch避免污染其他用例，完全不需要spy类自身的方法。

import sinon from 'sinon';
// 提前导入业务依赖：Foo类、HEADER_INFO常量、baseURL常量
// import { Foo, HEADER_INFO, baseURL } from './your-module-path';

describe('Foo 类单元测试', () => {
  let foo: Foo;
  let fetchStub: sinon.SinonStub;

  beforeEach(() => {
    // 用假参数初始化被测实例
    foo = new Foo("12345", "prod");
    // 替换全局fetch为测试桩
    fetchStub = sinon.stub(globalThis, 'fetch');
  });

  afterEach(() => {
    // 每次测试后还原所有被stub的原生方法，清除调用记录
    sinon.restore();
  });

  it('getInclusiveData 正常流程应正确发起请求、解析结果、赋值并返回', async () => {
    // 1. 准备模拟响应数据
    const mockResults = [{ id: 1, value: 'demo1' }, { id: 2, value: 'demo2' }];
    // 给fetch桩设置返回值：模拟标准Response对象结构
    fetchStub.resolves({
      json: async () => ({ results: mockResults })
    });

    // 2. 执行被测方法
    const result = await foo.getInclusiveData('testName');

    // 3. 全链路断言校验
    // 验证fetch仅被调用1次
    sinon.assert.calledOnce(fetchStub);
    // 验证请求地址、配置符合预期
    const [requestUrl, requestConfig] = fetchStub.firstCall.args;
    expect(requestUrl).toBe(`${baseURL}/v1/variations/match`);
    expect(requestConfig).toEqual({
      method: 'post',
      headers: HEADER_INFO
    });
    // 验证返回值正确
    expect(result).toEqual(mockResults);
    // 验证私有属性_names被正确赋值（单测中通过as any访问TS私有属性是通用做法）
    expect((foo as any)._names).toEqual(mockResults);
  });

  it('fetch请求报错时应正确抛出异常', async () => {
    // 模拟网络错误场景
    const mockNetworkError = new Error('request timeout');
    fetchStub.rejects(mockNetworkError);

    // 断言方法抛出对应错误
    await expect(foo.getInclusiveData('testName')).rejects.toThrow(mockNetworkError);
  });
});

额外代码优化提示 #

你当前的TS代码存在两个小问题，可以顺手修复：

• private _names: Array 没有指定泛型类型，会隐式退化为any[]，建议根据业务结构定义明确类型，比如private _names: Array<{id: number, name: string}>
• 构造函数接收的_accessToken、_environment，以及方法入参name目前都没有参与业务逻辑，如果不是预留字段，属于遗漏的业务逻辑，需要补充到请求配置（比如把token放到请求头、根据environment切换不同baseURL、把name参数放到请求体/URL参数中）

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