如何在Jest中测试React TypeScript类的私有方法

问题原因 #

你尝试通过Foo.prototype访问私有方法b报错，核心原因是TypeScript的private修饰符编译后，方法并不会挂载到类的原型上，而是作为实例自身的属性存在（不同编译目标下实现细节有差异，但原型链上找不到私有方法）。你之前的代码访问的是原型对象，自然找不到b方法。

解决方案 #

方案1：推荐——测试公共方法（而非直接测试私有方法） #

私有方法属于类的内部实现细节，更合理的测试方式是通过调用公共方法a，验证其触发的行为是否符合预期。可以用Jest的mock功能监听私有方法的调用：

// 测试代码示例
import { Foo } from './your-file-path';

describe('Foo', () => {
  it('should trigger private method b after Buzz completes', (done) => {
    const foo = new Foo();
    // 绕过TS类型检查，监听实例的b方法
    const bSpy = jest.spyOn(foo as unknown as { b: (msg: string) => void }, 'b').mockImplementation();
    
    foo.a();
    
    // 等待setTimeout异步执行完成
    setTimeout(() => {
      expect(bSpy).toHaveBeenCalledWith('Buzz completed');
      bSpy.mockRestore();
      done();
    }, 2000);
  });
});

方案2：直接调用私有方法（不推荐，仅特殊场景使用） #

如果确实需要直接调用私有方法，要访问实例对象而非原型对象，通过类型断言绕过TypeScript的私有访问限制：

const foo = new Foo();
// 断言实例包含b方法，绕过TS类型检查
const fooInstance = foo as unknown as { b: (msg: string) => void };
fooInstance.b('test message'); // 可正常调用

额外说明 #

• TypeScript的private是编译时的访问限制，运行时（JS环境）并没有真正的私有性，所以可以通过类型断言绕过，但这种方式会破坏类的封装性，不建议常规使用。
• 优先测试公共API的行为而非内部实现细节，这样测试会更健壮，不会因为类的内部重构而频繁修改测试代码。

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