使用 Bun 测试运行器将测试标记为“todo”

要提醒自己稍后编写测试，请使用 test.todo 函数。不要求提供实现。

test.test.ts

import { test } from "bun:test";

// write this later
test.todo("parses durations like 1h30m");

bun test 的输出会报告 todo 测试的数量。

terminal

bun test

test.test.ts:
✎ parses durations like 1h30m

 0 pass
 1 todo
 0 fail
Ran 1 test across 1 file. [6.00ms]

你也可以在被测试的代码尚未编写之前先写测试。这里的 parseDuration 仍是一个存根，而 todo 测试记录了它最终应该实现的功能。bun test 也会将此测试报告为 todo，但不会运行它的测试体。

test.test.ts

import { test, expect } from "bun:test";

// Not written yet; the todo test below says what it should do.
function parseDuration(input: string): number {
  throw new Error("not implemented");
}

test.todo("parses durations like 1h30m", () => {
  expect(parseDuration("1h30m")).toBe(5400);
});

传入 --todo 以运行 todo 测试的测试体。todo 测试_预期会失败_：由于 parseDuration 尚未实现，Bun 会打印错误，但仍将该测试计为 todo，并以代码 0 退出。

terminal

bun test --todo

test.test.ts:
1 | import { test, expect } from "bun:test";
2 |
3 | // Not written yet; the todo test below says what it should do.
4 | function parseDuration(input: string): number {
5 |   throw new Error("not implemented");
                                       ^
error: not implemented
      at parseDuration (/path/to/test.test.ts:5:36)
      at <anonymous> (/path/to/test.test.ts:9:10)
✎ parses durations like 1h30m [0.16ms]

 0 pass
 1 todo
 0 fail
Ran 1 test across 1 file. [5.00ms]

实现 parseDuration 并使测试体通过后，bun test --todo 会将该测试报告为失败，并以非零代码退出。这意味着你应该移除 .todo，将其变为常规测试。

test.test.ts:
✗ parses durations like 1h30m [0.19ms]
  ^ this test is marked as todo but passes. Remove `.todo` if tested behavior now works

 0 pass
 1 fail
 1 expect() calls
Ran 1 test across 1 file. [5.00ms]
$ echo $?
1 # 这是前一个命令的退出代码

另见：

跳过测试
编写测试。

概述

部署

运行时与调试

实用工具

生态系统与框架

HTTP 与网络

WebSocket

进程与系统

包管理器

测试运行器

运行时与调试

模块系统

文件系统

实用工具

HTML 处理

二进制数据

Streams

使用 Bun 测试运行器将测试标记为“todo”