Bombadil:不写测试步骤,只写页面该满足的属性,让它自己去乱点找 bug

如果你写过 Playwright 或 Cypress 的端到端测试,大概体会过:用例写得越多,维护越累,而且测的永远只是你想到的那几条路径。Bombadil 换了个思路:你不写步骤,只写"这个页面任何时候都应该满足什么",然后让它自己去乱点、乱输、乱跳,看会不会违反。

它是 Antithesis 开源的属性测试(Property-based testing,也就是常说的 fuzzing 思路)工具,针对 Web 和终端界面。今天它登上了 Rust 趋势榜,单日新增约 400 Star。

它解决什么问题

示例式的浏览器测试有两个老毛病:写起来贵,覆盖面窄。几条正常流程、几个回归用例,剩下大片状态空间没人碰。Bombadil 的做法是在状态空间里随机而系统地探索,去撞那些你没想过要测的情形:奇怪的操作顺序、异常的时序、忘了会被输入的内容。

它内部是一个循环:

  • 从浏览器里提取当前状态
  • 检查所有属性,记录违反情况
  • 根据当前状态选下一个动作并执行
  • 等下一个事件(页面跳转、DOM 变化或超时),回到第一步

只要页面用到 DOM,不管是单页应用、服务端渲染还是纯静态 HTML,都能测。

不写代码也能先跑起来

它自带一组默认属性和动作生成器。默认属性会检查未捕获异常、未处理的 Promise 拒绝、错误日志、HTTP 4xx/5xx 响应等;动作这边会在语义化的 HTML 元素上做导航和交互。所以不写任何规格,直接对着一个地址跑就行:

bombadil browser test https://your-app.example.com --output-path my-test

默认会一直跑到你按 Ctrl+C,违反的属性会作为错误打出来。跑完用 inspect 看结果:

bombadil browser inspect my-test

这会在浏览器里打开一个界面:左边是动作列表,底部是可以拖动的时间线,每次动作前后的状态都能对照着看,出现违反的地方会标上感叹号。

用 TypeScript 写自己的属性

想测业务逻辑,就写一个规格文件。它是普通的 ES 模块,导出属性和动作生成器。比如"页面标题任何时候都不为空":

const title = extract(state => state.document.title || "");

export const hasTitle = always(() => title.current !== "");

extract 在每个被捕获的状态上取数据,always 是时序算子,表示这个条件在每个状态下都必须成立。手册里还有"通知数量不超过上限""错误提示最终会消失""计数器状态机"等完整示例,可以当设计模式参考。跑的时候把规格文件跟在地址后面:

bombadil browser test https://example.com example.ts

复现和缩小问题

属性测试最让人头疼的是"随机撞出来的 bug 怎么复现"。Bombadil 把这块做进了工作流:

  • --reproduce 指向之前的 trace,可以重放同一串动作,用来验证修复
  • shrink 命令把冗长的触发路径缩成更短、但仍违反同一属性的版本。手册标注这个功能还是实验性的,参数和输出格式可能变
  • bombadil trace 可以在终端里列出状态、动作、URL 和违反情况,也能用 --json 交给 jq 处理

安装与接入 CI

可以直接装成项目的开发依赖:

npm install --save-dev @antithesishq/bombadil

然后在 package.json 里加一条脚本,比如 bombadil browser test --time-limit=1m https://your-app.example.com。也提供 macOS / Linux 的单文件二进制、Nix flake 和 Docker 镜像(docker run antithesishq/bombadil:0.7.10 --version)。CI 里可以用官方的 GitHub Action:antithesishq/bombadil-action@v2,能设置时间上限和发现违反即退出。

另外还有 terminal 驱动,可以用同样的属性思路去测 CLI、REPL 或 TUI 程序。

适合谁,注意什么

适合已经有一个前端项目,想在 CI 里加一道"自动乱点"的防线,或者对属性测试感兴趣、想试试它在 UI 上怎么落地的人。它不会取代你的关键流程用例,更像是补上那些没人写的边角。

需要留意的地方:项目 2025 年 12 月才创建,当前版本 v0.7.10,还在快速迭代;规格语言是自己的一套(基于 TypeScript,运行时有限制,依赖 Node 内置包的 npm 库可能用不了);真正有价值的属性得自己想清楚,默认属性只能抓到异常、报错这类通用问题。

项目信息