bun:test Test TypeScript interface | API Reference | Bun

Runs a test.

test("can check if using Bun", () => {
expect(Bun).toBeDefined();
});

test("can make a fetch() request", async () => {
const response = await fetch("https://example.com/");
expect(response.ok).toBe(true);
});

test("can set a timeout", async () => {
await Bun.sleep(100);
}, 50); // or { timeout: 50 }

Runs the test concurrently with other concurrent tests.

Marks this test as failing.

Use test.failing when you are writing a test and expecting it to fail. These tests will behave the other way normal tests do. If failing test will throw any errors then it will pass. If it does not throw it will fail.

test.failing is very similar to test.todo except that it always runs, regardless of the --todo flag.

Skips all other tests, except this test.

Forces the test to run serially (not in parallel), even when the --concurrent flag is used.

Skips this test.

Marks this test as to be written or to be fixed.

These tests will not be executed unless the --todo flag is passed. With the flag, if the test passes, the test will be marked as fail in the results; you will have to remove the .todo or check that your test is implemented correctly.

Runs the test concurrently with other concurrent tests, if condition is true.

if the test should run concurrently

Marks this test as failing, if condition is true.

if the test should be marked as failing

Runs this test, if condition is true.

This is the opposite of test.skipIf().

if the test should run

Forces the test to run serially (not in parallel), if condition is true. This applies even when the --concurrent flag is used.

if the test should run serially

Skips this test, if condition is true.

if the test should be skipped

Marks this test as to be written or to be fixed, if condition is true.

if the test should be marked TODO

Sets the number of times to repeat the test, regardless of whether it passed or failed.

Sets the number of times to retry the test if it fails.

Sets the timeout for the test in milliseconds.

If the test does not complete within this time, the test will fail with:

'Timeout: test {name} timed out after 5000ms'