test(e2e): 修 pollBoundingBox 自身的二次读取竞态,§14.2 登记逐条处置与探针否证
- 探针 docs/acceptance/2026-10-17-final/probe-logo.mjs 实测加载期无双字标可见窗口 (390x844 与 1280x800 各 60 次采样,双可见 0;唯一零可见是 t≈43ms header 尚未进 DOM) ⇒ 产品不闪,红来自辅助函数:expect.poll 等到非空后再单独读一次 boundingBox, hydration 亚 60ms 的重挂让第二次读取返回 null,被误报成「元素在断言瞬间消失」。 - 改为在同一次读取里既判非空又产出值;超时才 throw,且 throw 文案带轮询次数。 判据不降:仍要求非空 box + 原几何断言,没有 catch、没有静默通过。 - website-acceptance × 4 project 连跑两次各 56 passed。 - §14.2 表逐条登记:fail-open 修复 / 触摸目标与 region 命名 / 限流真因与双向用例 / 锚点重锚 / 引擎差异取证法(我上一个假设被自己的读数否掉)/ 本条竞态。
This commit is contained in:
1 parent
1e80167b7c
commit
fadc35b980
3 files changed
+69
-7
No files matched your search
@@ -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();
|
||||
@@ -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)读数随本节的收尾笔登记。
|
||||
@@ -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<BoxLike> {
|
||||
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' }, () => {
|
||||
|
||||
Reference in new issue
Block a user