终端实时查看 JavaScript 单元测试语句覆盖率的关键是利用 Jest 或 Vitest 的 watch 模式配合覆盖率配置,实现保存即显示 Statements 覆盖率数值及变化趋势,并可通过 coverage 对象手动验证具体语句执行情况。

终端实时查看 JavaScript 单元测试的语句覆盖率,关键在于让测试工具在每次重跑后立即输出简洁、可读的语句(Statements)覆盖数值,而不是等完整报告生成。Jest 和 Vitest 都支持这种“秒级反馈”,无需打开 HTML 页面。
用 Jest --watch + --coverage 直接看终端语句覆盖率
Jest 在 watch 模式下配合 --coverage 参数,每次保存文件后自动重跑,并在终端顶部输出带颜色的覆盖率摘要,其中 Statements 行就是语句覆盖率:
DMap GL地图JSAPI(dmapgl)开发指南。用于编写、审查、调试 DMap 地图 API 代码,涵盖地图初始化、覆盖物渲染、图层管理、事件处理、控件交互等任务。当用户提及 dmap、dmapgl、jsapi‑gl 或相关地图开发需求时自动触发。
- 确保 jest.config.js 中启用了收集:`collectCoverage: true`,并用 `collectCoverageFrom` 精确指定源码路径(如 ['src/**/*.{js,ts}'])
- 运行命令:npx jest --watch --coverage --coverageReporters=text-summary
- 保存任意测试或源码文件后,终端会刷新显示类似内容:
Statements: 87.2% (142/163)
Functions: 75.0% (12/16)
Branches: 68.4% (26/38)
Lines: 87.2% (142/163) - 注意:语句覆盖率(Statements)和行覆盖率(Lines)数值通常一致,但语句更细粒度——比如一行含两个表达式,会被算作两条语句
用 Vitest --watch 自动显示语句覆盖率变化
Vitest 的 watch 模式对语句覆盖率反馈更友好,不仅显示当前值,还标出升降箭头,一眼看出改代码是否提升了覆盖:
- 配置 vitest.config.ts 中启用覆盖率:
coverage: { provider: 'v8', reporter: ['text'], enabled: true } - 运行:npm run test -- --watch(或直接 vitest --watch)
- 每轮测试结束,终端底部固定区域会显示:
Statements: 91.5% (+0.8%) ✅
Functions: 82.3% (–0.2%) ⚠️
Branches: 76.1% (+1.4%) ✅ - 绿色 ↑ / 红色 ↓ 直观反映语句覆盖变动,适合边写逻辑边调测试
快速验证语句是否真被覆盖:控制台查 __coverage__
当终端数字和实际逻辑不符时,可手动确认某段代码是否真的执行过:
- 在浏览器开发者工具 Console 中输入:window.__coverage__(Vitest 默认挂载,Jest 需配
collectCoverageFrom+coverageProvider: 'v8') - 找到目标文件对象,查看
s字段(statements)——它是一个键值对数组,key 是语句序号,value 是执行次数 - 例如:
Object.values(__coverage__['src/math.js'].s)返回[1, 0, 2, 1],说明第 2 条语句执行次数为 0,即未覆盖 - 结合 debugger 断点,在单步执行中观察对应 value 是否从 0 变成 1,能精准定位遗漏点

















