代码覆盖率是衡量测试用例执行源代码比例的指标,主流工具为Istanbul(nyc),Jest/vitest内置支持,Mocha需手动集成;报告含Lines、Functions、Branches、Statements四维度;提升覆盖率需覆盖所有分支、异步逻辑、异常路径及react状态更新。

代码覆盖率是指测试用例执行时,源代码中被运行到的行、分支、函数或语句所占的比例。它不是质量保证的终点,但能帮你快速发现哪些逻辑路径没被测到——比如一个 if 分支永远没进过,或者某个工具函数压根没调用。
javaScript 中常用的覆盖率工具
目前最主流的是 Istanbul(及其命令行工具 nyc),它是 Babel、Jest、Vitest 等测试框架默认集成的覆盖率引擎。Vitest 和 Jest 内置了 Istanbul,开箱即用;如果你用原生 Mocha 或自定义测试流程,可以单独装 nyc。
- Jest:在 jest.config.js 里设
collectCoverage: true,再加coverageDirectory和coverageProvider: 'v8'(推荐,更快更准) - Vitest:默认不开启,加
coverage: { enabled: true }即可,底层用 c8(V8 引擎原生覆盖),比 Istanbul 更轻量 - 纯 node 脚本 + Mocha:用
nyc mocha test/*.js启动,会自动注入和报告
看懂覆盖率报告的关键指标
一份标准报告包含四类基础维度:
- Lines:有多少行代码被执行过(注意:空行、注释、只含花括号的行不计入)
- Functions:定义的函数里,有几个至少被调用了一次
- Branches:if/else、三元、逻辑与或等分支结构中,有多少分支路径被执行
- Statements:可执行语句(如赋值、return、throw)的执行比例,通常和 Lines 接近但不等价
例如:return a > 0 ? 'yes' : 'no' 算 1 个语句、1 个函数、2 个分支——只测 a > 0 为真,分支覆盖率就只有 50%。
立即学习“Java免费学习笔记(深入)”;
怎么写测试才能真正提升覆盖率?
别为了数字凑 coverage,重点是让测试暴露逻辑盲区:
- 每个 if / else / switch case 都要覆盖,包括边界条件(如
arr.Length === 0) - 异步代码记得 await 或 return promise,否则覆盖率统计会漏掉后续行
- try/catch 的 catch 块容易被忽略,可手动抛错或用 sinon.stub 模拟异常
- React 组件测试中,触发事件(如 fireEvent.click)后要等状态更新(act + waitFor),否则渲染相关行可能标红
基本上就这些。覆盖率本身不难跑,难的是理解它提示的问题——哪段逻辑脆弱、哪条路径危险、哪个参数组合没试过。把它当一面镜子,而不是 KPI。