教程 ↗

小型 Web 项目上线前:用两个真实失败挑出最小测试

用一个纯本地匿名报价页复现浮点金额和刷新丢失草稿,再把关键输入、边界、错误恢复和浏览器走查收敛成可运行的最小测试。

英文 Quote Lab 页面显示匿名报价表单与正确的 $0.30 小计

一个小型 Web 项目常常只有一个表单和几段计算代码。问题通常不在“有没有测试”,而在有限时间里先保护哪几个会让读者得到错误结果、丢失工作或卡在恢复步骤里的环节。

我做了一个只在本机运行的匿名报价页,把范围压到两个输入:数量和单价。页面无需账户,报价计算和草稿保存不调用后端接口;未完成的草稿只写入当前浏览器的 localStorage。这个限制让两类风险特别清楚:金额展示错误,以及用户在输入中途刷新后找不回草稿。

下载 完整可运行的 v1.0.0 实验包。包里有故障版本、修复版本、两条实际失败日志、六项通过的行为契约和运行说明。所有报价数据都是本次原创测试数据。

先用一次真实操作挑风险

我先把页面的读者操作写成一条很短的路径:匿名打开页面 → 输入数量和单价 → 看到小计 → 在计算前刷新 → 继续编辑或修正错误。

这条路径提出了四个需要明确检查的点:

风险最小检查本次实际产物
0.10 × 3 的二进制浮点尾数进入界面读者看到的金额必须是 $0.30故障测试退出码 1,修复后页面与契约测试均为 $0.30
正在输入的匿名草稿被刷新抹掉同一浏览器刷新后应读回 7 和 4.25故障页恢复为默认 3 / 0.10;修复页保留编辑值
边界或格式错误让人无法改回显示错误时保留当时输入数量 0 仍留在输入框,页面显示可操作的错误文字
已保存数据损坏页面应回到干净的可编辑状态损坏 JSON 被清除,页面显示恢复提示并给出默认草稿

这比先列“单元、端到端、快照”几种测试名更有用。每一行都对应用户可见的后果,也对应一个能复现的输入和输出。

第一处故障:金额看似简单,界面却暴露了内部尾数

故障基线直接把 JavaScript Number 的乘法结果拼进字符串。提交数量 3 和单价 0.10 后,页面出现的是 $0.30000000000000004。

故意保留的故障页面,$0.10 乘 3 显示为 $0.30000000000000004

图 1:故障基线实际显示的浮点尾数。

修复不依赖“最后显示时 round 一下”。输入先按最多两位小数解析成整数分,数量也先限制为 1 到 99 的整数;乘法在整数分上完成,最后才格式化为美元。这里最重要的检查不是 parsePriceToCents 这种内部函数有没有被调用,而是公开结果是否仍为 $0.30。

同一组契约还覆盖了两个边界:99 × 9999.99 显示为 $989,999.01;0、1e2 和 1.005 得到明确错误。它们刻意从输入和读者可见结果出发,因此即使以后换掉内部的金额实现,测试仍在检查同一条承诺。

第二处故障:刷新不是罕见的异常分支

故障页把编辑值留在内存里。输入 7 和 4.25 后,页面会提示它们只存在当前内存;刷新一次,输入又变成默认的 3 和 0.10。这不是登录、支付或网络失败才会触发的路径,匿名访问者也会遇到。

故障页面刷新后又显示默认数量 3 与单价 0.10

图 2:故障基线在中途编辑后无法恢复匿名草稿。

修复页在每次输入时把小草稿写入当前浏览器的本地存储。实际走查中,我在还没有点击“Calculate subtotal”前输入 7 和 4.25,刷新后两个值仍在表单中。

刷新后仍保留数量 7 与单价 4.25 的英文报价页

图 3:中途编辑后刷新,修复页读回同一份本地草稿。

这个决定有明确范围:它只帮助同一浏览器配置中的匿名用户继续当前工作,不提供跨设备同步,也不会承担订单或支付状态。把这个范围写在实现旁,能避免以后把“能继续填写”误读成“已经有完整账户系统”。

错误恢复要保留下一步动作

有效性检查不能只返回一个布尔值。实际浏览器走查中,把数量改成 0 后提交,页面显示 Quantity must be a whole number from 1 to 99.;输入框里的 0 和单价 4.25 没有被清空,读者可以直接改正。

数量为 0 时页面保留输入并显示可修正的错误提示

图 4:错误留在当前操作旁,输入没有消失。

还需要处理更少见但更难解释的一层:之前保存的值根本无法解析。为了验证这条恢复路径,我故意写入无效 JSON,再刷新页面。页面清掉那条坏数据,回到 3 和 0.10,并显示 Recovered a blank draft after unreadable saved data.。

保存数据不可读取后,页面显示恢复提示并回到干净默认草稿

图 5:不可读取的本地数据不会把表单困在空白或异常状态。

把“故障应该失败”也保留为证据

实验包没有把故障版本悄悄删掉。运行下面的命令时,前两条回归检查预期返回退出码 1,最后一条修复后的契约检查返回 0:

node scripts/run-evidence.mjs

这次运行使用 Node v26.0.0,结果是:

broken-money: status 1 (expected 1)
broken-draft: status 1 (expected 1)
fixed-contract: status 0 (expected 0)

失败日志分别保留实际值 $0.30000000000000004 与刷新后的默认草稿;修复测试有六项通过,覆盖金额、最大边界、三种无效输入、匿名刷新、损坏数据恢复和错误时的既有草稿。这样能区分“测试脚本成功运行”和“故障真的在被测试捕捉”。

浏览器走查补上代码看不到的地方

自动契约没有替代页面检查。我用本机静态服务在 127.0.0.1:4341 打开修复页,确认匿名说明、标签、错误文字、按钮和结果在桌面页面上一起出现;又以 390 × 844 的窄屏检查主要按钮、输入和 $0.30 输出仍在一段连续阅读路径中。

390 像素宽窄屏中的英文报价页,输入、两个按钮和 $0.30 结果均可见

图 6:窄屏走查中的修复页。

Playwright 的官方最佳实践建议把断言放在用户可见行为上、尽量隔离测试,并只测试可控部分。本实验采用这三个原则,但没有安装或运行 Playwright:可控的纯本地计算与草稿状态由 Node 契约测试覆盖,浏览器走查核对真实控件和恢复文字。官方建议是方法来源;这里的页面、输入、故障日志和截图是这次实验的实际结果。

如果你要把这个模式移到自己的小项目,先挑一条读者确实会完成的路径,再为每个会造成错误输出、丢失进度或无从恢复的风险准备一个输入。等这些最小契约和一次真实页面走查稳定后,再看有没有新的流程需要扩大测试范围。

← 返回列表