JavaScript代码覆盖率反映测试执行时源代码的行、语句、分支、函数被运行的比例，用于发现逻辑盲区但不衡量测试质量；主流工具包括nyc、Jest内置支持、c8及浏览器端方案，启用后需结合人工分析覆盖结果。
JavaScript 代码覆盖率衡量的是测试用例执行时，源代码中有多少行、分支、函数或语句被实际运行过。它不表示测试质量高低，但能帮你发现未被覆盖的逻辑盲区，比如遗漏的 if 分支、未调用的工具函数等。
常用覆盖率指标
主流工具通常支持以下四类基础指标（以 Istanbul 体系为代表）：
- 行覆盖率（Lines）：已执行的代码行数占总可执行行数的比例
- 语句覆盖率（Statements）：已执行的语句数量占比（比行更细，如一行含多个语句会单独计数）
- 分支覆盖率（Branches）：if/else、三元、逻辑与或等分支路径中，被触发的比例
- 函数覆盖率（Functions）：定义的函数中，被至少调用过一次的比例
主流 JS 覆盖率工具
目前最成熟、生态最广的是基于 Istanbul 的工具链，它本身是规范，不是单一工具：
-
nyc：Istanbul 的命令行封装，支持 Node.js 项目单测覆盖率（配合 Mocha/Jest 等）。例如：
nyc --reporter=html --reporter=text npm test，会生成 HTML 报告和终端摘要 -
Jest 内置支持：开箱即用覆盖率（默认使用 Istanbul），加
--coverage即可，还能通过collectCoverageFrom配置目标文件、排除类型声明或测试文件 - c8：基于 V8 引擎的原生代码覆盖率工具，比 nyc 启动更快、结果更准确（尤其对异步/ESM 支持更好），可作为 nyc 替代项，用法高度兼容
- Istanbul for Browser（如 karma-coverage + istanbul-instrumenter-loader）：用于前端浏览器环境，需配合 Karma 或 Webpack 构建流程，对源码插桩后收集运行时覆盖率数据
如何快速启用（以 Jest 为例）
多数现代项目无需额外安装 Istanbul 相关包。只需在 jest.config.js 中添加：
立即学习“Java免费学习笔记（深入）”；
module.exports = {
coverageDirectory: 'coverage',
coverageReporters: ['html', 'text-summary'],
collectCoverageFrom: [
'src/**/*.{js,jsx,ts,tsx}',
'!src/**/*.test.{js,jsx,ts,tsx}',
'!src/**/index.{js,jsx,ts,tsx}',
],
};
运行 jest --coverage 后，会在 coverage/ 下生成可视化 HTML 报告，点击文件可查看具体哪行未覆盖、哪个分支缺失。
注意事项与常见误区
覆盖率数字高 ≠ 代码健壮，需结合人工分析：
- 100% 行覆盖 ≠ 100% 分支覆盖（例如只测了 if 成立没测 else）
- 空函数、类型定义、纯样式组件等无业务逻辑的代码，不必强求覆盖
- 覆盖率阈值建议设为“增量检查”，比如 PR 提交时要求新增代码覆盖率达 80%，而非全量硬卡 90%
- 避免为凑覆盖率写无意义断言（如只调用不校验），应关注关键路径和边界条件
