Jest测试Vue项目时控制台覆盖率正常但HTML报告失效的问题排查
我正在使用Jest对Vue项目开展单元测试,控制台可正常输出代码覆盖率结果,无任何异常,但HTML格式的覆盖率报告无法正常生成。
当前相关配置如下:
package.json中的单元测试脚本配置:
... "unit": "jest --config test/unit/jest.conf.js --coverage", ...
jest.conf.js完整配置:
const path = require('path') module.exports = { verbose: true, testURL: "http://localhost/", rootDir: path.resolve(__dirname, '../../'), moduleFileExtensions: [ 'js', 'json', 'vue' ], moduleNameMapper: { '^@/(.*)$': '<rootDir>/src/$1' }, transform: { '^.+\\.js$': '<rootDir>/node_modules/babel-jest', '.*\\.(vue)$': '<rootDir>/node_modules/vue-jest' }, testPathIgnorePatterns: [ '<rootDir>/test/e2e' ], snapshotSerializers: ['<rootDir>/node_modules/jest-serializer-vue'], setupFiles: ['<rootDir>/test/unit/setup'], mapCoverage: true, coverageDirectory: '<rootDir>/test/unit/coverage', collectCoverageFrom: [ 'src/**/*.{js,vue}', '!src/main.js', '!src/router/index.js', '!src/plugins/vuetify.js', '!**/node_modules/**' ] }
未显式配置HTML覆盖率报告器(最常见原因)
Jest默认的coverageReporters配置为['text', 'lcov'],仅会在控制台输出文本格式的覆盖率结果、生成lcov格式的原始报告文件,不会主动生成可视化HTML报告。直接在jest.conf.js中新增如下配置即可:coverageReporters: ['text', 'html']重新运行测试后,就会在指定的
coverageDirectory(即test/unit/coverage目录)下生成index.html格式的可视化报告。已废弃的
mapCoverage参数引发兼容问题
配置中的mapCoverage: true是Jest v20及更早版本的专属参数,从Jest v21开始该参数已被完全移除,替换为coverageProvider配置项。若当前使用的Jest版本≥v21,该无效参数不仅不生效,部分版本还会直接中断覆盖率报告的生成流程,直接删除这行配置即可。覆盖率目录残留文件或权限冲突
若此前运行测试时test/unit/coverage目录已生成残留文件,且当前运行环境对该目录无写入权限,会导致HTML报告写入失败。可手动删除test/unit/coverage目录后重新执行测试脚本验证。依赖版本不匹配
若项目安装的Jest主版本与vue-jest、babel-jest版本不兼容,会导致报告生成环节的插件加载失败。可执行npx jest --version确认当前实际生效的Jest版本,对照官方文档匹配对应版本的相关依赖。
内容的提问来源于stack exchange,提问作者coffee-and-code

