如果你写过 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 库可能用不了);真正有价值的属性得自己想清楚,默认属性只能抓到异常、报错这类通用问题。
项目信息
- 语言:Rust(规格用 TypeScript 编写)
- License:MIT
- Star:截至 2026-11-17 约 2.5k
- 最新版本:v0.7.10(2026-10-21 发布)
- GitHub:GitHub - antithesishq/bombadil: Property-based testing for web and terminal UIs · GitHub
- 手册:The Bombadil Manual