/** * _helpers/wait.ts — 智能等待 helpers (避免 networkidle 慢等待) * * jnpf 6.2.0 SPA 特点: * - vue-router 跳转不触发整页 reload, networkidle 经常迟迟不到 * - 业务页 "渲染完" 的稳信号是某个特定元素出现 (菜单/表格行/弹窗) * * 原则: * - 用 page.waitForSelector(具体元素) 代替 waitForLoadState('networkidle') * - 默认 15s timeout, 比 networkidle 30s 快很多 * - 给 form 渲染留 500ms 缓冲 (antd v-model 异步) */ import type { Page } from '@playwright/test' import { SEL } from './selectors' /** * 等 jnpf SPA home 渲染完 (菜单可见) * @returns 第一个匹配到的选择器 (供后续 clickMenu 用) */ export async function waitSpaReady( page: Page, timeout = 15_000, ): Promise { for (const sel of SEL.MENU_ITEM_CANDIDATES) { try { await page.waitForSelector(sel, { timeout }) return sel } catch { continue } } return null } /** * 等 vxe-table 渲染完 (容器或数据行) * 不等 networkidle — jnpf 6.2.0 SPA 长连接 (心跳) 永远不停 */ export async function waitTableReady(page: Page, timeout = 15_000) { await page.waitForSelector( `${SEL.TABLE}, ${SEL.TABLE_ROW}`, { timeout }, ) // 给 vxe-table 渲染 + vue diff 一帧时间 await page.waitForTimeout(300) } /** * 等 modal 弹窗 + 内部 form 字段渲染完 * 500ms 缓冲: antd v-model 异步, 字段 placeholder/input 要等下一 tick */ export async function waitFormModalReady( page: Page, timeout = 10_000, ) { await page.waitForSelector(SEL.MODAL, { timeout }) // 等 modal 内至少 1 个 form-item 渲染 await page.waitForSelector(`${SEL.MODAL} ${SEL.FORM_ITEM}`, { timeout, }) await page.waitForTimeout(200) } /** * 等 modal 关闭 */ export async function waitModalClose( page: Page, timeout = 15_000, ) { await page.waitForSelector(SEL.MODAL, { state: 'hidden', timeout, }) } /** * 等列表行数变化 (新增/删除后) * @param before 新增/删除前的行数 * @param delta +1=期待增加, -1=期待减少 */ export async function waitRowCountChange( page: Page, before: number, delta: 1 | -1, timeout = 10_000, ) { const expected = before + delta const start = Date.now() while (Date.now() - start < timeout) { const count = await page.locator(SEL.TABLE_ROW).count() if (delta > 0 ? count > before : count < before) return count if (count === expected) return count await page.waitForTimeout(200) } throw new Error( `waitRowCountChange: ${timeout}ms 内行数没从 ${before} 变到 ${expected}`, ) }