JavaScript 中怎么设置覆盖率报告不包含工具生成的代码-js教程-PHP中文网

javascript测试覆盖率失真主因是babel/ts等工具生成的辅助代码被计入，应通过jest的collectcoveragefrom白名单、coveragepathignorepatterns黑名单、禁用tslib内联、istanbul注释及修复source map映射来精准过滤。

javascript 中怎么设置覆盖率报告不包含工具生成的代码

在 JavaScript 项目中生成测试覆盖率报告时，常会把 Babel、TypeScript 编译器、Webpack 或 Jest 自身注入的辅助代码（如 __awaiter、__generator、regeneratorRuntime、Babel runtime helpers）也计入覆盖率，导致数据失真。要排除这些工具生成的代码，核心是让测试覆盖率工具（如 jest + istanbul）在收集和报告阶段跳过它们。

配置 Jest 的 collectCoverageFrom + coveragePathIgnorePatterns

这是最常用且直接的方式。Jest 默认使用 Istanbul（via babel-jest 或 ts-jest）收集覆盖率，通过以下两个配置协同过滤：

collectCoverageFrom：显式声明哪些源码文件参与覆盖率统计（白名单思维）
coveragePathIgnorePatterns：在已匹配的文件中，进一步忽略特定路径或文件名模式（黑名单补充）

示例 jest.config.js：

module.exports = {
  collectCoverageFrom: [
    'src/**/*.{js,jsx,ts,tsx}',
    '!src/**/*.d.ts',
    '!src/**/index.{js,ts}', // 可选：忽略入口聚合文件
  ],
  coveragePathIgnorePatterns: [
    '/node_modules/',
    '/dist/',
    '/lib/',
    '/coverage/',
    '.*\.test\.(js|ts)x?$',
    '.*\.spec\.(js|ts)x?$',
    'globalSetup\.js$',
    'globalTeardown\.js$',
    // 忽略 Babel/TS 工具生成的辅助代码（通常出现在编译后输出或内联）
    'babel-runtime',
    'regenerator-runtime',
    '@babel/runtime',
    'tslib',
  ],
};

在 TypeScript 项目中禁用 tslib 内联辅助代码

TypeScript 默认开启 importHelpers: true 并依赖 tslib，其 helper 函数（如 __extends、__decorate）会被插入到每个编译后的文件里。虽然它们属于“工具生成”，但因混在源文件编译结果中，coveragePathIgnorePatterns 无法精准剔除单个函数。

解决方法：

Java Maven Code Review

审查Java Maven项目（ZIP压缩包或GitLab仓库URL），检查代码规范、命名、模块边界、可维护性问题以及重复代码。

下载

在 tsconfig.json 中设 "importHelpers": false（不推荐：增大包体积）
更推荐：保持 importHelpers: true，但将 tslib 声明为 external（如用 Webpack 打包时），或确保测试运行的是原始 TS 源码（而非编译后 JS）——即用 ts-jest 直接转译，此时 Istanbul 可基于源码映射（source map）准确归因，而 tslib 的 helper 本身不被纳入 collectCoverageFrom 路径，自然不参与统计

使用 istanbul ignore 注释（细粒度控制）

对个别无法通过路径过滤的工具代码（比如某段手动引入的 polyfill 或动态注入的 runtime），可在代码中添加注释标记，让 Istanbul 跳过该区域：

// istanbul ignore next
if (typeof window !== 'undefined') {
  window.myPolyfill = createPolyfill();
}

支持的注释形式包括：

// istanbul ignore next（忽略下一行）
// istanbul ignore if（忽略整个 if 块）
// istanbul ignore file（忽略整个文件，放在文件顶部）

注意：需确保测试配置中未禁用 reporters 的 text-summary 或 html，且 Istanbul 版本支持（v1.0+ 均支持）。

检查 source map 是否正确映射源码

如果用了 Babel 或 TS 编译，但覆盖率仍显示大量 __* 函数被覆盖，很可能是 Istanbul 没能正确映射回原始源码，导致它把编译产物当作了“源文件”。请确认：

Babel 配置中 sourceMaps: true（或 inlineSources: true）已启用
Jest 配置中 transformSourceCode 或 ts-jest 的 isolatedModules: false（推荐）以保留完整 source map
运行 jest --coverage --coverageReporters=text 查看是否提示 “Some files are missing from the coverage report due to missing source maps”

修复 source map 后，覆盖率将基于原始 .ts/.js 文件计算，工具生成的辅助代码（不在你的源码里）就不会出现在报告中了。