Skip to main content
bun test 的文件发现机制决定了哪些文件会作为测试运行。理解其工作原理有助于你有效地组织测试文件。

​
默认发现逻辑

默认情况下，bun test 会递归搜索项目目录中符合特定模式的文件：
  • *.test.{js|jsx|ts|tsx} - 以 .test.js、.test.jsx、.test.ts 或 .test.tsx 结尾的文件
  • *_test.{js|jsx|ts|tsx} - 以 _test.js、_test.jsx、_test.ts 或 _test.tsx 结尾的文件
  • *.spec.{js|jsx|ts|tsx} - 以 .spec.js、.spec.jsx、.spec.ts 或 .spec.tsx 结尾的文件
  • *_spec.{js|jsx|ts|tsx} - 以 _spec.js、_spec.jsx、_spec.ts 或 _spec.tsx 结尾的文件

​
排除项

默认情况下，Bun 测试会忽略：
  • node_modules 目录
  • 隐藏目录（以句点 . 开头的目录）
  • 没有 JavaScript 类扩展名的文件（基于可用的加载器）

​
自定义测试发现

​
位置参数作为过滤器

你可以通过向 bun test 传递额外的位置参数来过滤运行的测试文件：
terminal
bun test <filter> <filter> ...
任何文件路径包含其中一个过滤器的测试文件都会被运行。这些过滤器是简单的子字符串匹配，而非通配符模式。 例如，运行 utils 目录下的所有测试：
terminal
bun test utils
这将匹配类似 src/utils/string.test.ts 和 lib/utils/array_test.js 的文件。

​
指定精确文件路径

要在测试运行器中运行特定文件，确保路径以 ./ 或 / 开头，以区别于过滤器名称：
terminal
bun test ./test/specific-file.test.ts

​
按测试名称过滤

要根据测试名称而非文件路径过滤测试，使用 -t/--test-name-pattern 选项并传入正则表达式模式：
terminal
# 运行所有名称中包含 "addition" 的测试
bun test --test-name-pattern addition
该模式会匹配一个由测试名称和其所有父 describe 块标签按空格连接组成的字符串。例如，定义如下测试：
https://mintcdn.com/ikxin/RzFFGbzo0-4huILA/icons/typescript.svg?fit=max&auto=format&n=RzFFGbzo0-4huILA&q=85&s=a3dffd2241f05776d3bd25171d0c5a79math.test.ts
describe("Math", () => {
  describe("operations", () => {
    test("should add correctly", () => {
      // ...
    });
  });
});
将匹配字符串 “Math operations should add correctly”。

​
更改根目录

默认情况下，Bun 从当前工作目录开始查找测试文件。你可以通过 bunfig.toml 中的 root 选项更改此目录：
bunfig.toml
[test]
root = "src"  # 仅扫描 src 目录下的测试

​
执行顺序

测试的执行顺序如下：
  1. 测试文件按顺序执行（非并行）
  2. 每个文件内的测试按照定义顺序顺序执行