Bun 的测试运行器现在支持内置的 代码覆盖率报告。这使得查看代码库中有多少被测试覆盖变得容易，并找到当前未充分测试的区域。
启用覆盖率
bun:test 支持查看哪些代码行被测试覆盖。要使用此功能，请将 --coverage 传递给 CLI。它将在控制台打印出覆盖率报告
$ bun test --coverage
-------------|---------|---------|-------------------
File | % Funcs | % Lines | Uncovered Line #s
-------------|---------|---------|-------------------
All files | 38.89 | 42.11 |
index-0.ts | 33.33 | 36.84 | 10-15,19-24
index-1.ts | 33.33 | 36.84 | 10-15,19-24
index-10.ts | 33.33 | 36.84 | 10-15,19-24
index-2.ts | 33.33 | 36.84 | 10-15,19-24
index-3.ts | 33.33 | 36.84 | 10-15,19-24
index-4.ts | 33.33 | 36.84 | 10-15,19-24
index-5.ts | 33.33 | 36.84 | 10-15,19-24
index-6.ts | 33.33 | 36.84 | 10-15,19-24
index-7.ts | 33.33 | 36.84 | 10-15,19-24
index-8.ts | 33.33 | 36.84 | 10-15,19-24
index-9.ts | 33.33 | 36.84 | 10-15,19-24
index.ts | 100.00 | 100.00 |
-------------|---------|---------|-------------------
要始终默认启用覆盖率报告，请将以下行添加到您的 bunfig.toml 中
[test]
# always enable coverage
coverage = true
默认情况下，覆盖率报告将 包含 测试文件并 排除 源代码映射。这通常是您想要的，但可以在 bunfig.toml 中进行其他配置。
[test]
coverageSkipTestFiles = true # default false
覆盖率阈值
可以在 bunfig.toml 中指定覆盖率阈值。如果您的测试套件未达到或超过此阈值，bun test 将以非零退出代码退出以指示失败。
[test]
# to require 90% line-level and function-level coverage
coverageThreshold = 0.9
# to set different thresholds for lines and functions
coverageThreshold = { lines = 0.9, functions = 0.9 }
源代码映射
在内部，Bun 默认编译所有文件，因此 Bun 会自动生成一个内部的 源代码映射，将您的原始源代码行映射到 Bun 的内部表示。如果出于任何原因您想禁用此功能，请将 test.coverageIgnoreSourcemaps 设置为 true；这在高级用例之外很少是可取的。
[test]
coverageIgnoreSourcemaps = true # default false
覆盖率报告器
默认情况下，覆盖率报告将打印到控制台。
对于 CI 环境和其他工具中的持久代码覆盖率报告，您可以传递 --coverage-reporter=lcov CLI 选项或 bunfig.toml 中的 coverageReporter 选项。
[test]
coverageReporter = ["text", "lcov"] # default ["text"]
coverageDir = "path/to/somewhere" # default "coverage"
| 报告器 | 描述 |
|---|---|
文本 | 将覆盖率的文本摘要打印到控制台。 |
lcov | 以 lcov 格式保存覆盖率。 |
lcov 覆盖率报告器
要生成 lcov 报告，您可以使用 lcov 报告器。 这将在 coverage 目录中生成一个 lcov.info 文件。
[test]
coverageReporter = "lcov"