From 03be1c9e362a7009465b2792eb2b5e498cf61f2a Mon Sep 17 00:00:00 2001 From: zhangxiang Date: Wed, 21 Oct 2026 16:57:47 +0800 Subject: [PATCH] =?UTF-8?q?test(visual):=20=E9=A6=96=E9=A1=B5=E7=BC=BA=20d?= =?UTF-8?q?ata-cms-state=20=E6=97=B6=E5=88=A4=E7=BA=A2=EF=BC=8C=E9=81=BF?= =?UTF-8?q?=E5=85=8D=E5=AE=88=E5=8D=AB=E9=80=80=E5=8C=96=E6=88=90=E6=AD=BB?= =?UTF-8?q?=E5=88=A4=E6=8D=AE?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 上一版写成「有标记就校验、没有就跳过」。可标记正是这条守卫存在的理由: prop 没透传、组件换成旧版、属性改名,任何一种都会让守卫静默失效, 而用例照样绿——正是「备好但从未跑成」的那类自伤。 改为按路径判定:`/` 必须带标记且为 ok,否则按名字报错;其它页面跳过。 正控:25 个首页相关用例全绿(标记确实在 DOM 里且为 ok)。 负控:临时把属性去掉 ⇒ 立刻红,报「首页缺少 data-cms-state 标记」。 --- e2e/visual-regression.spec.ts | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/e2e/visual-regression.spec.ts b/e2e/visual-regression.spec.ts index 916580e..c8b3956 100644 --- a/e2e/visual-regression.spec.ts +++ b/e2e/visual-regression.spec.ts @@ -112,10 +112,17 @@ async function waitForRevealsSettled(page: Page) { /** * 首页把 CMS 读数状态写在 `data-cms-state` 上。退化时页面照常 200、只是整套落到常量版式, * 像素比对只会给出一团无从归因的差异 —— 在这里先按名字判一次。 + * 首页**必须有**这个标记:标记消失(改坏 prop / 改回旧组件)时不能静默放行, + * 否则这条守卫会退化成永不生效的死判据。其它页面不标,跳过。 */ async function assertCmsStateOk(page: Page) { + const isHome = new URL(page.url()).pathname === '/'; + if (!isHome) return; + const marker = page.locator('main [data-cms-state]').first(); - if ((await marker.count()) === 0) return; + if ((await marker.count()) === 0) { + throw new Error('首页缺少 data-cms-state 标记:CMS 退化守卫已失效(见 lessons §5.51)'); + } const state = await marker.getAttribute('data-cms-state'); if (state !== 'ok') { throw new Error(