maxConcurrentTasks 四处兜底、两个值¶
症状¶
没有症状 —— 这正是它的性质。
它不报错、不触发类型问题、测试也不会红。唯一的外在表现是 「并发数时多时少」,而那恰好是最难复现、最容易被归给「网络波动」的那类现象。
事实¶
| 位置 | 兜底值 |
|---|---|
src/utils/storage-data.ts DefaultSettings |
2 ← 真相源 |
src/entrypoints/background/batch-controller.ts |
2 |
src/entrypoints/background/task-manager.ts |
1 |
src/sections/task/task-view.tsx useState |
2 |
src/sections/task/task-view.tsx onSuccess |
1 |
触发条件是 s.maxConcurrentTasks 取不到值 —— 首次启动(storage 还没写过)、
storage 读失败、或该字段被存成 0(|| 对 0 也会走兜底)。
此时:
- 调度器(
task-manager.pumpTasks)认为空槽有 1 个 ⇒ 一次只起一个任务 - 批控制器(
batch-controller)认为全局上限是 2 ⇒ 按 2 个在跑来算配额 - 界面(
task-view)初始显示 2,读一次设置后变 1
三方对同一个数字给出三种答案,且没有任何一处会察觉不一致。
为什么会长成这样¶
不是谁写错了,是四处分别在不同版本被加进来,每处都「顺手写了个合理的默认」。
DefaultSettings 是后来才有的,先写的那几处没有回去改。
🔴 判据:一个值出现在两个地方,就已经是两个值了 —— 它们只是恰好现在还相等。
修¶
三处兜底全部改引 DefaultSettings.maxConcurrentTasks,并新增
tests/settings-default-single-source.test.ts 钉死:三处不得出现字面量兜底。
3 条定向变异(三处分别退回字面量)3/3 被抓。
⚠️ 写这道闸时踩的坑:测试不能 import 真相源¶
第一版写的是:
storage-data.ts 顶层有 storage.defineItem(...),import 的一瞬间就去碰 chrome.runtime,
node 环境抛 Unhandled Rejection。
现象很阴:Tests 3 passed 照常打印,而进程 rc=1。
只看测试摘要会以为全绿,只有看退出码才发现不对。
⇒ 改为纯源码断言 —— 真相源的值也从源码正则里读。 这就是本仓其它同类测试一律用源码断言的原因:凡是顶层有 wxt / jsstore 副作用的模块,测试都碰不得。
元教训¶
这一条和 0152-settings-misleading-copy-four-mines 是同一类: 没有任何类型或逻辑能守住「两个地方的值相等」这件事。
前者靠文案闸守,后者靠单一源 + 源码断言守。共同点是 必须把「不变量」写成可执行的断言,否则它只活在写代码那个人的脑子里。
🔴 v0.10.181 追修:v0.10.180 只修了一半¶
对抗审 terra-dsh 与 dshf 两路独立指出:三处 || 字面量 是收归了,
但两个 catch 分支原样留着 return 1 与 return 2。
而上面「事实」一节写的触发条件第一条就是 storage 读失败 —— 那正是 catch 走的路。
⇒ 修的是自己描述的场景里最次要的那一半(读到了但值为空),
最典型的那一半(根本没读到)原封不动,而本文当时已标 fixed。
闸也没拦住:断言只匹配 maxConcurrentTasks || <数字>,
dshf 实测把 task-manager 的 catch 改成 return 9,测试全绿。
修:两处 catch 改引 DefaultSettings.maxConcurrentTasks;
断言扩到 catch 块内(切函数体取 catch {...} 再判),两条定向变异各自打红。
连带发现第 5 个消费点:tests/create-task-ingest-why-not-run.test.ts 的
storage-data mock 必须补 DefaultSettings 导出,而补的那一刻它就成了第 5 个
「并发默认值等于几」的说法 ⇒ 再加一条断言把 mock 值钉回真相源。
教训:「同一个值出现在几个地方」这个数,每次都比上一次数出来的多一个。 数它没有用,把「必须相等」写成断言才有用。