fix(gates): axe 底色哨兵改从令牌取值(它抄的那份字面量早已过期),并补终局验证读数
`check:axe` 首跑 EXIT=1,其中 `bgMismatch=36` 的红因写着
「底色不等于令牌值 ⇒ 样式未加载」—— 两句**都是错的**:
样式加载得好好的(light 侧逐页相等、对比度节点 0),
错的是哨兵自己抄了一份令牌值。
副本漂移的证据链:
- `axe-node-count.mjs:52` 硬编码 `EXPECTED_BG = { light:'rgb(255, 255, 255)',
dark:'rgb(10, 14, 20)' }`;
- 暗色底在 P1 暖色迁移(**本分支基线 `da9a5cb6` 之前**)就是 `--color-bg-primary: #141210`
/ `-rgb: 20 18 16`;
- `git diff da9a5cb6..HEAD -- src/app/globals.css` 里**没有任何** `color-bg-primary` 改动
⇒ 不是本轮引入;`git log -S "rgb(10, 14, 20)"` 定位到字面量入库那一笔。
归因先于修闸:少了这一步,很容易把它读成「本批改坏了」。
修法是把**副本换成真源**,而不是把副本改成新值(那只是再抄一遍,下次换色板还会红):
现读 `--color-bg-primary-rgb` 三元组当场拼期望色。
实测读到了错诊断的代价:一个失效的哨兵会**顺带伪造一句错的诊断**。
改完重做负对照,证明没把闸调瞎(§5.34 那类"全站 CSS 404 仍 exit 0"的反面):
- 临时移走 `dist/standalone/dist/static` 起服务 ⇒ `expected=""`、
`actual="rgba(0, 0, 0, 0)"` ⇒ 判红(`probe-bg-negative.mjs` 以 EXIT=0 表达
「负对照成立」);
- 装配完好 ⇒ `expected="rgb(20, 18, 16)"` 与 `actual` 相等 ⇒ 判绿。
另记一条同轮事实:本次改造漏改一处 `pageBg` 引用,闸以
`FATAL: 扫描中断(uncaughtException):pageBg is not defined` 崩掉而不是静默通过 ——
这正是退出码分档(0 通过 / 1 判红 / 2 未能度量 + FATAL 独立路径)兑现价值的地方;
而 `scripts/**/*.mjs` 不在 `tsconfig` 覆盖内,只有真跑才暴露(§5.43 同族)。
终局验证补跑读数(装配后的 standalone 产物,详见台账 §11.6):
- `check:axe:routes` 清单 **35 条** → `check:axe` **EXIT=0**:
`bgMismatch=0`、`contrastNodes=0`、`violationNodes=0`、`extraRuleNodes=0`、
`extraRuleCoveragePairs=105`、`non2xxResponses=1`(期望内的 `/_not-found`)、
`unexpectedStatus=0`。
- `test:visual:all -- --update-snapshots=none` 复跑 **104 failed / 21 passed**
(五 project 均匀 21/21/20/21/21),**0 例 element-not-found、0 例超时**。
与首跑 109/16 的差值全部归因到那 5 条 `founder-quote-section` 死选择器
(区块按裁定已删除 ⇒ 区域截图永不可能命中),已在上笔改写为反向守卫并变异验证。
⇒ 剩下的 104 条**都是像素不符**,即本批语法改动的预期外溢:
**AUTH-VISUAL 的重采量是这 104 张**,不是"基线全坏"。
- `test:e2e:prod`:`UJ-01/02/03/08/10` × chromium + chromium-mobile ⇒ **14 passed**。
⚠ GA4 那 16 例在本 worktree **仍 skipped**:worktree 没有 `.env.production`,
而 `NEXT_PUBLIC_GA_MEASUREMENT_ID` 是 **build 期烘焙**进客户端产物的 ⇒
「prod 目标下 GA4 才真断言」这条口径在缺该文件的树上不成立,
须记为**未取证**而不是通过。
ISR 冻结产物的最终闭环:删自造 `uj03-test-news-*` 行(连带 `AuditLog.targetId`
与 `ContentZone.items` 的 JSON 引用)→ `npm run build`(`news.html` 里 uj03 命中 0)
→ 重跑 routes + axe。纪律不变:**重置 ISR 只能靠重建或 revalidate,不许手删 `dist/**`**。
文档:台账 §11.6、`docs/lessons-learned.md` §5.44 + 更新记录一行、
探针 `probe-bg.mjs` / `probe-bg-sentinel.mjs` / `probe-bg-negative.mjs` / `probe-drawer.mjs`。
复跑:`type-check` EXIT=0、`lint` EXIT=0(0 error / 81 warning)、
`check:visual` EXIT=0(grammar 11/11 + accents 成立,两条自证先跑)、
`jest` 1747 例、`build` EXIT=0。
This commit is contained in:
1 parent
133faaba1b
commit
0157b1c9f5
7 files changed
+472
-96
No files matched your search
@@ -48,8 +48,25 @@ const EXTRA_RULES = [...CANONICAL_EXTRA_RULES];
|
||||
const ENGINES = [['chromium', chromium], ['firefox', firefox]];
|
||||
const THEMES = ['light', 'dark'];
|
||||
const COMBOS = ENGINES.length * THEMES.length; // 4 个「引擎 × 主题」组合
|
||||
// 底色必须等于本站令牌值:未加载样式时所有元素都落在默认黑白底上,对比度会「意外通过」。
|
||||
const EXPECTED_BG = { light: 'rgb(255, 255, 255)', dark: 'rgb(10, 14, 20)' };
|
||||
/**
|
||||
* 底色哨兵:页面的 body 底色必须等于**令牌自己声明的值**。
|
||||
* 为什么要有这条:样式没加载时所有元素都落在默认黑白底上,对比度会「意外通过」,
|
||||
* 于是 axe 给出一个漂亮的 0 违规 —— 这条哨兵就是用来把那种「意外达标」判红的。
|
||||
*
|
||||
* ⚠ 原实现把期望值**硬编码成两条字面量**(light #FFF、dark `rgb(10, 14, 20)`),
|
||||
* 而 P1 暖色迁移早在本分支基线 `da9a5cb6` 之前就把暗色底改成了暖墨
|
||||
* (`--color-bg-primary-rgb: 20 18 16`)⇒ 闸的哨兵从此**恒红**,
|
||||
* 本轮实测 `bgMismatch=36`(chromium/dark 与 firefox/dark 各 36 页)。
|
||||
* 归因核过:`git diff da9a5cb6..HEAD -- src/app/globals.css` 里**没有**任何
|
||||
* `color-bg-primary` 改动 ⇒ 不是本轮引入,是「令牌改了、闸里的抄本没跟」,
|
||||
* 与本仓 `check:token-twins` 守的是同一类病(一个语义有多条表示通道)。
|
||||
*
|
||||
* 修法不是把字面量改成新值 —— 那只是把抄本再抄一遍,下次换色板还会红。
|
||||
* 现改成**从令牌自己取值**:读 `--color-bg-primary-rgb` 三元组拼成期望色,
|
||||
* 哨兵的失败模式不变(CSS 没加载时该自定义属性解析为空 ⇒ 期望串拼不出来 ⇒ 判红),
|
||||
* 但对色板变更免疫。
|
||||
*/
|
||||
const BG_TRIPLET_VAR = '--color-bg-primary-rgb';
|
||||
// 逐页状态码期望:清单里绝大多数路由必须 2xx/3xx,`/_not-found` 是本站 404 页、**期望** 404。
|
||||
// 为什么必须逐页判:404/500 页几乎没有可比对节点,`violationNodes` 仍为 0,而 `s.pages` 计数照加;
|
||||
// 聚合保险丝 `okResponses > 0` 只在**全部**响应都非 2xx 时才炸 ⇒ 单个路由退化成 404 会被当「干净」计过。
|
||||
@@ -147,10 +164,19 @@ for (const [engineName, launcher] of ENGINES) {
|
||||
...ruleRes.violations, ...ruleRes.passes, ...ruleRes.incomplete, ...ruleRes.inapplicable,
|
||||
].map((r) => r.id));
|
||||
const covered = CANONICAL_EXTRA_RULES.filter((id) => ruleIds.has(id));
|
||||
const pageBg = await page.evaluate(() => getComputedStyle(document.body).backgroundColor);
|
||||
// 一次 evaluate 同时取「实际底色」与「令牌声明的底色」,避免两次读之间主题被切换
|
||||
const bgRead = await page.evaluate((varName) => {
|
||||
const root = getComputedStyle(document.documentElement);
|
||||
const triplet = (root.getPropertyValue(varName) || '').trim();
|
||||
const parts = triplet.split(/\s+/).filter(Boolean);
|
||||
const expected = parts.length >= 3 ? `rgb(${parts.slice(0, 3).join(', ')})` : '';
|
||||
return { actual: getComputedStyle(document.body).backgroundColor, expected };
|
||||
}, BG_TRIPLET_VAR);
|
||||
rows.push({
|
||||
engine: engineName, theme, url, observedTheme, statusCode, pageBg,
|
||||
bgMatchesToken: pageBg === EXPECTED_BG[theme],
|
||||
engine: engineName, theme, url, observedTheme, statusCode,
|
||||
pageBg: bgRead.actual,
|
||||
expectedBg: bgRead.expected,
|
||||
bgMatchesToken: bgRead.expected !== '' && bgRead.actual === bgRead.expected,
|
||||
violationRules: violations.length,
|
||||
violationNodes: violations.reduce((a, v) => a + v.nodes, 0),
|
||||
contrastNodes: violations.filter((v) => v.id === 'color-contrast').reduce((a, v) => a + v.nodes, 0),
|
||||
@@ -161,7 +187,7 @@ for (const [engineName, launcher] of ENGINES) {
|
||||
violations,
|
||||
extraRuleViolations: ruleViolations,
|
||||
});
|
||||
console.log(`${engineName}/${theme} ${url} status=${statusCode} theme=${observedTheme} bg=${pageBg} rules=${violations.length} nodes=${rows.at(-1).violationNodes} contrast=${rows.at(-1).contrastNodes} extra=${rows.at(-1).extraRuleNodes}/${covered.length}/${rows.at(-1).extraRulesChecked}`);
|
||||
console.log(`${engineName}/${theme} ${url} status=${statusCode} theme=${observedTheme} bg=${bgRead.actual}|期望 ${bgRead.expected} rules=${violations.length} nodes=${rows.at(-1).violationNodes} contrast=${rows.at(-1).contrastNodes} extra=${rows.at(-1).extraRuleNodes}/${covered.length}/${rows.at(-1).extraRulesChecked}`);
|
||||
}
|
||||
await ctx.close();
|
||||
}
|
||||
|
||||
Reference in new issue
Block a user