bun-test

Run all tests

$ bun test

$ bun test [path/to/test.ts]

$ bun test --test-name-pattern "[pattern]"

$ bun test --watch

$ bun test --update-snapshots

$ bun test --coverage

$ bun test --reporter=junit --reporter-outfile=[results.xml]

$ bun test --timeout [5000]

bun test [options] [files]

bun test is Bun's built-in test runner with a Jest-compatible API. It provides TypeScript and JSX support, snapshot testing, mocks, lifecycle hooks, and watch mode out of the box.
Tests execute with the Bun runtime, providing significantly improved performance over traditional JavaScript test runners.

--watch

Re-run tests on file changes

Update snapshot files

Enable code coverage reporting

Only run tests matching pattern

Test timeout in milliseconds

Output format (default, junit, etc.)

Write reporter output to file

Stop after n test failures

Run each test n times

The test runner searches for files matching:
- *.test.{js,jsx,ts,tsx}
- *_test.{js,jsx,ts,tsx}
- *.spec.{js,jsx,ts,tsx}
- *_spec.{js,jsx,ts,tsx}

Tests use describe, test/it, expect, beforeAll, beforeEach, afterEach, afterAll, and mock functions from bun:test module.

While aiming for Jest compatibility, not all Jest features are implemented. GitHub Actions annotations are automatically enabled when running in CI. Some Jest-specific plugins may not work.

bun(1), bun-run(1), jest(1), vitest(1)