Jest watch模式重跑测试未识别源码变更 如何配置构建最新代码

问题根源 #

watch模式下测试结果不随源码变更更新，核心原因是两层缓存未正确失效：

• ts-jest默认缓存TypeScript转译后的JS产物，watch模式下文件变更事件未触发对应缓存键更新时，会直接复用旧编译结果
• Jest默认保留模块require缓存，重跑测试时不会重新加载修改后的模块，直接使用内存中已加载的旧版本代码

具体修复步骤 #

• 替换jest.config.js配置，显式关闭不合理的缓存策略，配置ts-jest正确转译规则：

module.exports = {
  testEnvironment: 'node',
  roots: ['<rootDir>'],
  testMatch: ['**/*.test.ts'],
  // 每次测试重跑前重置所有模块注册表，强制重新require所有依赖文件
  resetModules: true,
  transform: {
    '^.+\\.tsx?$': ['ts-jest', {
      // 启用单文件转译模式，跳过跨文件类型检查的缓存逻辑，提升转译速度同时避免缓存不更新
      isolatedModules: true,
      // 显式绑定项目tsconfig，避免ts-jest读取到错误的编译配置
      tsconfig: '<rootDir>/tsconfig.json'
    }]
  },
  // 排除无需监听的目录，避免无关文件变更干扰Jest的文件变更判定逻辑
  watchPathIgnorePatterns: ['node_modules', 'cdk.out'],
  // 关闭Jest全局transform缓存，从根源避免旧转译产物被复用
  cache: false
};

• 清除本地已存在的历史Jest缓存，避免旧缓存干扰新配置生效，在项目根目录执行命令：

npx jest --clearCache

• 调整package.json中的测试脚本，增加--no-cache参数兜底，确保watch模式下不会读取任何缓存，同时修正原配置中JSON多余尾逗号的语法问题：

{
  "scripts": {
    "test-watch": "jest --watchAll --no-cache",
    "ts": "ts-node ./lambda/index.ts"
  },
  "devDependencies": {
    "@types/jest": "^27.5.0",
    "esbuild": "^0.14.48",
    "eslint": "^8.19.0",
    "jest": "^27.5.1",
    "ts-jest": "^27.1.4",
    "ts-node": "^10.7.0",
    "typescript": "~3.9.7"
  }
}

验证方式 #

重新执行npm run test-watch启动监听，修改任意会导致现有测试用例失败的源码逻辑，保存后Jest重跑会正确识别变更，返回符合最新代码逻辑的测试结果。

注：如果开启isolatedModules后出现类型检查缺失的问题，可以把该配置改为false，搭配cache: false和resetModules: true配置同样可以解决缓存不更新问题，只是首次转译速度会稍慢。

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