前端代码质量检查中 JS 覆盖率报告怎么配置输出-js教程-PHP中文网

js覆盖率报告需通过jest/vitest等测试运行器配合istanbul/nyc/c8生成，关键在正确配置coverage选项、source map及源码路径匹配；jest启用collectcoverage并设coveragedirectory、reporters、include/exclude等；vitest需启用coverage.enabled并选reporter、include/exclude；须基于未压缩带sourcemap的开发构建产物运行测试，避免dist文件覆盖，ts需确保ts-jest/vitest正确映射，esm动态导入需显式包含；运行--coverage命令生成报告，打开coverage/index.html查看，ci可上传lcov.info至codecov分析。

前端代码质量检查中 js 覆盖率报告怎么配置输出

JS 覆盖率报告通常通过测试运行器（如 Jest、Vitest 或 Karma）配合代码覆盖率工具（如 Istanbul / nyc）生成，关键在于正确配置测试框架的 coverage 选项，并确保源码映射（source map）和构建产物路径匹配。

使用 Jest 时启用覆盖率并定制输出

Jest 内置基于 Istanbul 的覆盖率支持，只需在 jest.config.js 中添加或调整 coverage 相关配置：

collectCoverage: true — 启用覆盖率收集
coverageDirectory: 'coverage' — 指定输出目录（默认也是 coverage）
coverageReporters: ['html', 'lcov', 'text-summary'] — 输出多种格式，其中 html 可直接打开查看详细文件级/行级覆盖情况
collectCoverageFrom — 明确指定需统计的源码路径，例如：
['src/**/*.{js,jsx,ts,tsx}', '!src/**/*.test.{js,jsx,ts,tsx}']
coverageThreshold（可选）— 设置最低覆盖率阈值，低于则测试失败，例如：
{ global: { statements: 80, branches: 75, functions: 85, lines: 80 } }

使用 Vitest 生成覆盖率报告

Vitest 基于 istanbul-lib-instrument 和 c8（推荐）或 istanbul 提供覆盖率支持。在 vite.config.ts 或 vitest.config.ts 中配置：

dmap-jsapi-skill

DMap GL地图JSAPI（dmapgl）开发指南。用于编写、审查、调试 DMap 地图 API 代码，涵盖地图初始化、覆盖物渲染、图层管理、事件处理、控件交互等任务。当用户提及 dmap、dmapgl、jsapi‑gl 或相关地图开发需求时自动触发。

下载

启用 coverage.enabled = true
选择 reporter：coverage.reporter = ['html', 'lcov', 'text-summary']
指定源码范围：coverage.include = ['src/**/*.{js,ts}']
排除测试文件：coverage.exclude = ['**/*.test.*', 'node_modules/']
若用 c8（更轻更快），需安装 npm install -D c8 并设置 coverage.provider = 'c8'

确保覆盖率结果准确的关键细节

前端项目常因构建、转译或模块解析导致覆盖率失真，需注意：

测试应运行在 未压缩、带 source map 的开发/测试构建产物 上（如 vite dev server 或 jest 的 ts-jest/babel 处理后代码）
避免对打包后的 dist 文件做覆盖率 — 那反映的是 bundle 覆盖，不是源码真实覆盖
若用 TypeScript，确认 ts-jest 或 vitest 正确处理了 .ts → .js 的映射，否则 HTML 报告中可能显示编译后代码而非源码
ESM 动态导入、代码分割（如 React.lazy）可能导致部分模块未被 instrument，可在 collectCoverageFrom 中显式包含，或检查是否遗漏了异步加载路径