Test Reporters

bun test supports different output formats through reporters, both built-in and custom.

Built-in Reporters#

Default Console Reporter#

By default, bun test outputs results to the console in a human-readable format:

test/package-json-lint.test.ts:
✓ test/package.json [0.88ms]
✓ test/js/third_party/grpc-js/package.json [0.18ms]
✓ test/js/third_party/svelte/package.json [0.21ms]
✓ test/js/third_party/express/package.json [1.05ms]

 4 pass
 0 fail
 4 expect() calls
Ran 4 tests across 1 file. [8.00ms]

When a terminal doesn't support colors, the output avoids non-ASCII characters:

test/package-json-lint.test.ts:
(pass) test/package.json [0.48ms]
(pass) test/js/third_party/grpc-js/package.json [0.10ms]
(pass) test/js/third_party/svelte/package.json [0.04ms]
(pass) test/js/third_party/express/package.json [0.04ms]

 4 pass
 0 fail
 4 expect() calls
Ran 4 tests across 1 file. [9.00ms]

Dots Reporter#

The dots reporter shows . for passing tests and prints full error details for failures, useful for large test suites.

bun test --dots
bun test --reporter=dots

JUnit XML Reporter#

For CI/CD environments, Bun can generate JUnit XML reports. JUnit XML is a widely-adopted test result format that many CI/CD systems can parse, including GitLab and Jenkins.

Using the JUnit Reporter#

To generate a JUnit XML report, use the --reporter=junit flag along with --reporter-outfile to specify the output file:

bun test --reporter=junit --reporter-outfile=./junit.xml

Console output is unchanged; Bun writes the JUnit XML report to the specified path at the end of the test run.

Configuring via bunfig.toml#

You can also configure the JUnit reporter in bunfig.toml:

[test.reporter]
junit = "path/to/junit.xml"  # Output path for JUnit XML report

Environment Variables in JUnit Reports#

The JUnit reporter includes environment information as <properties> in the XML output, so you can tell which environment and commit a test run was for.

It includes the following environment variables when available:

Current Limitations#

The JUnit reporter does not include:

• stdout and stderr output from individual tests
• Precise timestamp fields per test case

GitHub Actions reporter#

bun test detects when it's running inside GitHub Actions and emits GitHub Actions annotations to the console directly. No configuration is needed beyond installing Bun and running bun test.

For an example GitHub Actions workflow, see CI/CD integration.

Custom Reporters#

You can implement custom test reporters with Bun's testing-specific extensions to the WebKit Inspector Protocol, which report detailed information about test execution in real time.

Inspector Protocol for Testing#

Bun extends the standard WebKit Inspector Protocol with two custom domains:

1. TestReporter: Reports test discovery, execution start, and completion events
2. LifecycleReporter: Reports errors and exceptions during test execution

Key Events#

Custom reporters can listen for these events:

• TestReporter.found: Emitted when a test is discovered
• TestReporter.start: Emitted when a test starts running
• TestReporter.end: Emitted when a test completes
• Console.messageAdded: Emitted when console output occurs during a test
• LifecycleReporter.error: Emitted when an error or exception occurs