FlowJS中import *导入时Mock函数赋值失败的问题与解决

这个报错其实是Flow的类型系统在帮你守住边界——它认为exampleFunc是一个只读属性，不允许被重新赋值。常见的触发原因有这几个：

• Flow类型定义里标记了只读：如果你的exampleAll的类型是类似下面这样的，那个加号+就表示exampleFunc是只读属性，Flow会严格禁止你修改它：

  type ExampleType = {
    +exampleFunc: () => void,
  };
  const exampleAll: ExampleType = { exampleFunc: () => {} };
  

• 对象被冻结/密封：如果代码里用了Object.freeze(exampleAll)或者Object.seal(exampleAll)，不仅JS运行时会阻止修改，Flow也会识别这种不可变状态并报错。
• 类的原型方法限制：如果exampleFunc是类的实例方法，虽然JS默认允许修改，但Flow可能会把类方法视为只读属性（尤其是当类被设计为不可变的时候），从而拦截你的赋值操作。

根据不同的场景，我整理了几个实用的解决方案，从快速解决到最佳实践都有：

1. 用类型断言快速绕开检查（应急用） #

如果你确定测试场景下修改属性是安全的，可以用Flow的类型断言告诉类型系统“我清楚自己在做什么”。最简单的方式是用any断言：

(exampleAll as any).exampleFunc = jest.fn();

要是想更精确（避免滥用any），可以定义一个去掉只读限制的类型变体，再做断言：

type MutableExampleType = {
  exampleFunc: () => void, // 去掉readonly的加号
};
(exampleAll as MutableExampleType).exampleFunc = jest.fn();

2. 用jest.spyOn替代直接赋值（更优雅） #

jest.spyOn是Mock方法的标准操作，它不会直接替换属性，而是给原方法添加一个“间谍”，同时允许你替换实现。这种方式通常能绕过Flow的只读检查：

jest.spyOn(exampleAll, 'exampleFunc').mockImplementation(() => {
  // 这里写你的Mock逻辑
});
// 或者更简洁的写法
jest.spyOn(exampleAll, 'exampleFunc').mockImplementation(jest.fn());

如果Flow还是报错，给spyOn加个简单的断言就行：

jest.spyOn(exampleAll as any, 'exampleFunc').mockImplementation(jest.fn());

3. 从设计层面优化（最佳实践） #

最好的方式是提前在代码设计时考虑测试性，从根源上避免这个问题：

• 依赖注入：不要直接依赖全局的exampleAll，而是把它作为参数传入需要调用exampleFunc的函数/模块。测试时直接传入一个Mock对象即可：

  // 业务代码
  function doSomething(deps: ExampleType) {
    deps.exampleFunc();
  }
  
  // 测试代码
  const mockDeps = { exampleFunc: jest.fn() };
  doSomething(mockDeps);
  

• 定义测试专用类型：在测试文件里扩展原类型，取消只读限制：

  import type { ExampleType } from './your-module';
  type TestExampleType = $ReadOnly<ExampleType> & {
    -exampleFunc: () => void, // 减号用来取消readonly标记
  };
  const testExample = exampleAll as TestExampleType;
  testExample.exampleFunc = jest.fn();
  

4. 处理被冻结/密封的对象 #

如果exampleAll被冻结了，直接修改肯定会失败，这时候可以先深拷贝对象，再修改拷贝后的版本：

import _ from 'lodash'; // 用深拷贝工具实现，或者自己写一个简单的深拷贝
const mutableExample = _.cloneDeep(exampleAll);
mutableExample.exampleFunc = jest.fn();
// 测试时用这个mutableExample就行

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