diff --git a/docs/acceptance/2026-10-17-final/probe-logo.mjs b/docs/acceptance/2026-10-17-final/probe-logo.mjs new file mode 100644 index 0000000..fce6592 --- /dev/null +++ b/docs/acceptance/2026-10-17-final/probe-logo.mjs @@ -0,0 +1,31 @@ +import { chromium } from 'playwright'; +const b = await chromium.launch(); +for (const vp of [{ width: 390, height: 844 }, { width: 1280, height: 800 }]) { + const ctx = await b.newContext({ viewport: vp }); + const p = await ctx.newPage(); + const samples = []; + await p.goto('http://localhost:3299/', { waitUntil: 'commit' }).catch(() => {}); + for (let i = 0; i < 60; i++) { + const s = await p.evaluate(() => { + const imgs = [...document.querySelectorAll('header a[aria-label="返回首页"] img')]; + const vis = imgs.filter((im) => { const r = im.getBoundingClientRect(); return r.width > 0 && r.height > 0; }); + return { + t: Math.round(performance.now()), + total: imgs.length, + vis: vis.length, + visCls: vis.map((im) => (im.getAttribute('class') || '').split(' ')[0]).join('|'), + theme: document.documentElement.getAttribute('data-theme') ?? '-', + firstVisibleBoxH: vis[0] ? Math.round(vis[0].getBoundingClientRect().height) : null, + }; + }).catch(() => null); + if (s) samples.push(s); + await p.waitForTimeout(60); + } + const multi = samples.filter((s) => s.vis > 1); + const zero = samples.filter((s) => s.vis === 0); + console.log(`viewport ${vp.width}x${vp.height}: 采样 ${samples.length} · 双可见 ${multi.length} · 零可见 ${zero.length} · 首次 data-theme=${samples.find((s) => s.theme !== '-')?.t ?? '未出现'}ms`); + if (multi.length) console.log(' 双可见样本:', JSON.stringify(multi.slice(0, 3))); + if (zero.length) console.log(' 零可见样本:', JSON.stringify(zero.slice(0, 3))); + await ctx.close(); +} +await b.close(); diff --git a/docs/acceptance/qa-tracker.md b/docs/acceptance/qa-tracker.md index d02ab6e..1b151a7 100644 --- a/docs/acceptance/qa-tracker.md +++ b/docs/acceptance/qa-tracker.md @@ -1028,3 +1028,21 @@ schema 落地后不能拿"之前绿过"当终版读数,故整链重跑(`docs 按 (1)(3) 两组逐条修根因 —— 漏锚的 spec 按 §11.3 同一手法以实测 DOM 重锚; `p1:579`、`p4:338/396`、触摸目标两条与 `@admin` 三条必须先复现再定性(产品缺陷还是测试口径), 不允许用放宽断言或加 retry 换绿。(2) 的 axe 既有红另案。 + +### 14.2 逐条修完后:36 → 4 → 终跑,并把「测试自己的竞态」与「产品缺陷」分开处理 + +按 §14.1 的定性逐条动手,全部有复算读数: + +| 类别 | 处置 | 读数 | +|---|---|---| +| 产品侧真缺陷 | `detail-trust-section` 渲染绕过门槛(fail-open)⇒ 改回 `publishableCases.map` | 变异验证:回退 ⇒ 2 条精确转红、1 条仍绿;恢复 ⇒ 35 例 EXIT=0 | +| 产品侧 a11y | 4 个文字链接触摸目标 23px < 24px(WCAG 2.5.8)⇒ 走 `min-h-6` 间距刻度;能力面板 `role="region"` 缺可访问名 ⇒ 补 `aria-label` | 触摸目标两 spec × 4 project 复跑通过;`p1/p4/p2/website-acceptance` 定点跑 chromium 81 passed | +| 限流真因 | 登录是**进程内内存桶** 10 次/15 分钟/IP,dev server 跨整轮存活 ⇒ `@admin` 旅程第 11 次登录起必得 429(这就是「单跑绿、全量红」)。额度改为可按环境覆盖,**默认仍 10**(生产姿态一字未动),只在 e2e harness 抬到 500 | `route.test.ts` 双向用例:未设 ⇒ 10;设 3 ⇒ 第 4 次判限流。9 例 EXIT=0 | +| 测试锚点过期 | `mobile.spec:45`、`website-acceptance:139` 按真源 `navigation.ts` 重锚(一级只剩 行业/能力/洞察/关于我们;联系入口是 `consult-button` 而非导航项) | `website-acceptance` × 4 project 连跑两次各 56 passed | +| 引擎行为 | `p4:403 焦点管理`:webkit / chromium-mobile 上 Tab 不落到链接(Safari 系需系统级「Press Tab to highlight each item」)。我先前试 `bringToFront` + 点空白**没有用** —— 假设被自己的读数否掉;改为同契约按引擎取证(chromium 走真实键盘,其余显式 focus 跳转链接),断言一条不减 | 2 passed(chromium-mobile + webkit) | +| **测试自身的竞态** | `pollBoundingBox` 先 `expect.poll` 等到非空、**再单独读一次** boundingBox ⇒ hydration 亚 60ms 的重挂会让第二次读取返回 null,被误报成「元素在断言瞬间消失」。改成在同一次读取里既判非空又产出值 | 探针 `docs/acceptance/2026-10-17-final/probe-logo.mjs` 实测:加载期**无双字标可见窗口**(0 次),唯一零可见是 t≈43ms header 尚未进 DOM ⇒ 产品不闪烁,问题在辅助函数 | + +⇒ 判据强度核对:以上没有一处是"放宽断言/加 retry/删用例"。两处改了测法(焦点、boundingBox 取值) +都是**把两次读取合成一次**或**换等价但跨引擎可靠的手段**,几何与非空断言原样保留。 + +终跑(4 project 全量功能 E2E)读数随本节的收尾笔登记。 diff --git a/e2e/website-acceptance.spec.ts b/e2e/website-acceptance.spec.ts index 2053069..734243d 100644 --- a/e2e/website-acceptance.spec.ts +++ b/e2e/website-acceptance.spec.ts @@ -14,16 +14,29 @@ interface BoxLike { * 旧写法 `const box = await expect.poll(() => el.boundingBox()).not.toBeNull()` 的 * await 结果是 undefined(断言不产数),随后的 `if (box)` 恒假 ⇒ 几何断言全部死代码。 * 本函数把「等到非空」与「拿到值」分开,且拿不到值直接 throw(元素消失 ⇒ 用例失败)。 + * + * 2026-10-17(§14)再修一次自身的竞态:上一版先 `expect.poll` 等到非空, + * **再单独调一次** `boundingBox()` 取值 —— 两次读取之间若赶上 header hydration 重挂 + * (实测探针:加载期无「双字标可见」窗口,只有 t≈43ms 时 header 尚未进 DOM 的一瞬, + * 采样步长 60ms 抓不到的亚 60ms 卸载也足以让第二次读取返回 null), + * 就会把「值拿到了但那一瞬间元素换了节点」误报成「元素在断言瞬间消失」。 + * ⇒ 改成在**同一次读取**里既判非空又产出值:读到非空立即返回,超时才 throw。 + * 判据强度不降:仍然要求最终拿到一个非空 box 并做几何断言,也没有 catch/静默通过。 */ async function pollBoundingBox(target: Locator, timeout = 5000): Promise { - await expect - .poll(() => target.boundingBox(), { timeout, message: '等待 boundingBox 就绪' }) - .not.toBeNull(); - const box = await target.boundingBox(); - if (!box) { - throw new Error('boundingBox 在轮询通过后仍为 null(元素在断言瞬间消失)'); + const deadline = Date.now() + timeout; + let lastMissing = 0; + for (;;) { + const box = await target.boundingBox().catch(() => null); + if (box) return box; + lastMissing += 1; + if (Date.now() > deadline) { + throw new Error( + `boundingBox 在 ${timeout}ms 内始终为 null(轮询 ${lastMissing} 次全部拿不到几何 ⇒ 元素不存在或不可见)`, + ); + } + await new Promise((r) => setTimeout(r, 50)); } - return box; } test.describe('网站全面测试验收', { tag: '@regression' }, () => {