docs(lessons): §5.51 视觉门禁的红位会随并行漂移——是 dwell 竞态,不是基线过期
只读比对在 4 worker 下给出 121 passed / 4 failed,原样重跑红位换了一批 (chromium-tablet 两例转绿),同一批用例 --workers=1 重跑 10/10 通过。逐行差分 显示差异只在长页中部一条带内、带内 actual 是空白 ⇒ 内容停在 opacity:0, 即 waitForPageStable 的 120ms dwell 在 CPU 争用下没能把 whileInView 提交完。 同时更正 §5.50 末尾「视觉全量 125/125」的口径:那是并行下偶然取到的一次读数, 不能当可复现证据。
This commit was merged in pull request #32.
This commit is contained in:
1 parent
97a3c1bda9
commit
9ea8d5f495
1 file changed
+28
@@ -923,3 +923,31 @@ if [ "$A" -eq 0 ] && [ "$B" -eq 0 ]; then git add … && git commit … && git p
|
||||
|
||||
⇒ 通用判据:**跨路由的「等旧页退场再挂新页」不能依赖 framer 的 presence 状态机;
|
||||
新页面挂载不得以旧页面的动画完成作为前置条件。**
|
||||
|
||||
### 5.51 视觉门禁在 4 worker 并行下可红可绿:是 dwell 不够,不是内容漂移(2026-10-20)
|
||||
|
||||
**现象**:在 `3fabb77c` 上只读比对 `visual-regression.spec.ts`(本批未碰 `/team`、`/about/brand`
|
||||
任何文件)得 **121 passed / 4 failed / EXIT=1**;紧接着原样重跑同一批用例,失败集合换了一批
|
||||
——`chromium-tablet` 的两例转绿,红位移到 `chromium-mobile` 与 `webkit`。
|
||||
|
||||
**误判风险**:这种红最容易被读成「基线过期 / seed 内容漂移」,进而 `--update-snapshots` 重写
|
||||
基线,把竞态固化成参照。§5.50 的「视觉全量 125/125」正是并行下偶然取到的一次读数,
|
||||
不足以当可复现证据——本条更正它。
|
||||
|
||||
**取证**:对 actual/expected 做逐行差分 ⇒ 差异只落在长页中部约 1.4k px 的一条带内
|
||||
(`/team` 的「团队文化」段;两图页高都是 12638,不是整体位移)。带内 **actual 是空白**,
|
||||
expected 是已显影正文 ⇒ 内容停在 `opacity:0` 初始态,而不是像素变了。
|
||||
|
||||
**机理**:`waitForPageStable`(`e2e/visual-regression.spec.ts:54-59`)逐屏滚动的步长 dwell 只有
|
||||
120ms。§5.50 把「直接跳到底」改成逐屏滚的方向是对的(IntersectionObserver 只回调当前视口内的
|
||||
目标),但 IO 回调与 framer 的 `whileInView` 提交都要排帧;4 worker 抢 CPU 时 dwell 不够,
|
||||
中间某屏就被跳过。判别实验:同一批用例 `--workers=1` 重跑 **10 passed / 0 failed / EXIT=0**。
|
||||
|
||||
**修法**(独立动作,未随本批落地):dwell 提到 ≥250ms 且每步排空一帧
|
||||
(`requestAnimationFrame`);或给 `ScrollReveal` 加一个「已显影」可查询标记供用例等待——
|
||||
现在 `src/components/ui/scroll-reveal.tsx:80-96` 只透传 `className`,这条写不出来。
|
||||
门禁口径:视觉层默认执行方式钉成 `--workers=1`,否则 `test:all` 里这一层可红可绿。
|
||||
|
||||
⇒ 通用判据:**失败集合会随并行漂移 = 装配竞态,不是被测对象的缺陷。**动基线之前先用
|
||||
`--workers=1` 复跑一次;「换 project 后红位是否移动」就是竞态的判别实验,而「基线过期」
|
||||
的红位是稳定的。
|
||||
Reference in new issue
Block a user