跳转至

替身声称「不假装成功 / 天然隔离」,两条都不成立;注释声称「顺序无关」,实际影响三处列表

怎么发现的

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) 可存活十几个版本。差别在于有没有人正好去消费那条声明。