替身声称「不假装成功 / 天然隔离」,两条都不成立;注释声称「顺序无关」,实际影响三处列表
怎么发现的¶
jsdom 基建(v0.16.24)送 terra-dsh 对抗审查,它报了三条 X_FAKE。主控复核后全部坐实。
三条¶
① 替身说「不假装成功」,而它永远成功¶
tests/stubs/wxt-browser.ts 头注白纸黑字:
🔴 设计原则:响亮地什么都不做,不要假装成功。
而实现是 sendMessage: vi.fn(async () => ({ success: true }))。
为什么要紧:本仓有一整个 issue 家族(ISSUE-0036 / 0039 / 0040)就是 「sendMessage 后未查 resp.success」。将来有人写组件测试验「失败时有没有提示」, 这个替身会让它永远走成功分支还显示绿 —— 正好把那个家族的回归网架空。
② 替身说「天然隔离」,实测串味¶
头注:「每个测试文件有自己的模块实例,天然隔离。」
审查方实跑证伪:同一个文件里多个 it 之间共享模块实例,
模块级 const mem = new Map() 和所有 vi.fn() 都会累积。
而且导出的 __resetStorage 全仓零调用。
tests/setup-dom.ts 的 afterEach 只调 cleanup()(卸载组件树),
不清 storage、不清 mock 计数 ⇒ toHaveBeenCalledTimes 这类断言会累积出错。
③ 注释说「顺序无关」,实际影响三处用户可见列表¶
src/utils/fetch-rows-snapshot.ts:
各窗内部已经 id DESC;跨窗没有可比较的全局顺序要求,派生统计/筛选均与顺序无关。
执行方做完顺序消费者审计,找到三处依赖首遇顺序的(主控自查只找到第一处):
| 消费者 | 机制 | 后果 |
|---|---|---|
| emails | data-view.tsx:483-500 seen.has(key) continue |
决定邮箱列表显示哪个商家的 name / website / sourceDomain |
| websites | data-view.tsx:441-460 score(r) > score(existing) —— 严格大于 |
同分时保留先遇到那行 |
| phones | phone-merge.ts:550 splitAndDedupePhones 的 seen / byKey |
首遇占位 |
主控把三段复制粘贴改成 INDEPENDENT_WINDOW_STATUSES.map(...) 循环时,
顺序恰好保持了 [2, 0, 3] ⇒ 行为没变,是运气不是验证。
修法¶
- ①
sendMessage默认抛说明性错误,逼调用方显式 mock(成功或失败都写出来) - ②
setup-dom.ts的afterEach=cleanup + __resetStorage + vi.clearAllMocks🔴 选clearAllMocks而非resetAllMocks:执行方核对@vitest/spy 3.2.4源码(dist/index.js:104-121)确认mockClear只清 calls/instances/invocations、 保留 implementation 与 once 队列 ⇒ 治得了「计数跨 it 累积」又不误伤模块级实现。 残留风险:不清mockImplementationOnce队列(根治需mockReset,会误伤,未做) - ③ 订正注释、点名三处消费者,并加一条硬编码期望值的顺序判据
判据¶
tests/wxt-browser-stub-honesty.test.tsx(3 条)—— 反向变异:改回{success:true}⇒ 红 2 条tests/stub-isolation.test.tsx(3 条)—— 先红后绿实跑:修前 2 failed, 且把setup-dom.ts临时换成旧版复跑同样 2 failed(证明红来自缺失的 afterEach 而非别处)tests/fetch-rows-snapshot.test.ts+1 条顺序判据 —— 变异[2,0,3]→[0,2,3]⇒ 红
🔴 教训:三条的共同结构¶
声明是一个不变量,却没有任何东西在它被违反时失败。
执行方给的可操作做法(已采纳进 behavior-level-predicates):
把「写声明」和「写它的最便宜反例」绑成同一个原子动作—— 凡注释/头注里出现全称或否定量词(不 / 不会 / 永远 / 都 / 均 / 无关 / 天然 / 独立 / 只), 落笔时必须当场写下并跑一次三行以内的证伪观察; 写不出就删掉该声明,或降级成「未验证假设」。
这三条的反例都廉价且立刻红:
① expect(await browser.runtime.sendMessage({})).not.toEqual({ success: true });
② 同一测试文件两个 it 共写读一个 key
③ 调换常量数组顺序,看返回值/派生列表变不变
⇒ 它们不属于「只能事后审查发现」的那类,而是把意图当结论写、没当假设验。
不能把事后审查当防线¶
执行方给的现实估计:这类基建声明能被当天的对抗审在天级抓出, 而同形态的注释漂移(0162-dead-param-and-wiki-lied-for-12-versions) 可存活十几个版本。差别在于有没有人正好去消费那条声明。