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 覆盖率报告通常通过测试运行器（如 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 中显式包含，或检查是否遗漏了异步加载路径
快速验证与查看报告
配置完成后，运行测试命令即可生成报告：
- Jest：
jest --coverage或npm test -- --coverage - Vitest：
vitest run --coverage（默认不启动 UI，适合 CI） - 生成后进入 coverage/index.html，用浏览器打开即可交互式查看各文件覆盖率、缺失行高亮等
- CI 场景下可上传 coverage/lcov.info 到 Codecov 或 Coveralls 等平台做趋势分析
