From 73b3fb7b0fa7cc786e147ccf1247cd9883ad8e59 Mon Sep 17 00:00:00 2001 From: Colin McDonnell Date: Thu, 24 Aug 2023 22:28:07 -0700 Subject: Add guides for test runner (#4308) --- docs/guides/test/coverage.md | 44 ++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 44 insertions(+) create mode 100644 docs/guides/test/coverage.md (limited to 'docs/guides/test/coverage.md') diff --git a/docs/guides/test/coverage.md b/docs/guides/test/coverage.md new file mode 100644 index 000000000..6103dbb90 --- /dev/null +++ b/docs/guides/test/coverage.md @@ -0,0 +1,44 @@ +--- +name: Generate code coverage reports with the Bun test runner +--- + +Bun's test runner supports built-in _code coverage reporting_. This makes it easy to see how much of the codebase is covered by tests, and find areas that are not currently well-tested. + +--- + +Pass the `--coverage` flag to `bun test` to enable this feature. This will print a coverage report after the test run. + +The coverage report lists the source files that were executed during the test run, the percentage of functions and lines that were executed, and the line ranges that were not executed during the run. + +```sh +$ bun test --coverage + +test.test.ts: +✓ math > add [0.71ms] +✓ math > multiply [0.03ms] +✓ random [0.13ms] +-------------|---------|---------|------------------- +File | % Funcs | % Lines | Uncovered Line #s +-------------|---------|---------|------------------- +All files | 66.67 | 77.78 | + math.ts | 50.00 | 66.67 | + random.ts | 50.00 | 66.67 | +-------------|---------|---------|------------------- + + 3 pass + 0 fail + 3 expect() calls +``` + +--- + +To always enable coverage reporting by default, add the following line to your `bunfig.toml`: + +```toml +[test] +coverage = true # always enable coverage +``` + +--- + +Refer to [Docs > Test runner > Coverage](/docs/test/coverage) for complete documentation on code coverage reporting in Bun. -- cgit v1.2.3