Writing tests Test configuration Runtime behavior Finding tests Lifecycle hooks Mocks Snapshots Dates and times DOM testing Code coverage Test Reporters

Writing tests

Write tests with Bun's Jest-compatible API, including async tests, timeouts, and test modifiers

Test configuration

Configure bun test behavior with bunfig.toml and command-line options

On this page

Basic Usage Grouping Tests Async Tests Timeouts Retries and Repeats test.retry test.repeats 🧟 Zombie Process Killer Test Modifiers test.skip test.todo test.only test.if test.skipIf test.todoIf test.failing Conditional Tests for Describe Blocks Parametrized Tests test.each and describe.each Argument Passing Format Specifiers Examples Assertion Counting expect.hasAssertions()expect.assertions(count)Type Testing expectTypeOf Matchers Basic Matchers String and Array Matchers Object Matchers Number Matchers Function and Class Matchers Promise Matchers Mock Function Matchers Snapshot Matchers Utility Matchers Not Yet Implemented Best Practices Use Descriptive Test Names Group Related Tests Use Appropriate Matchers Test Error Conditions Use Setup and Teardown