标准库 (dacli/tests/e2e/_helpers/, 6 文件 ~800 行): - selectors.ts: JNPF 6.2.0 通用选择器常量 (SEL/formItemByLabel/rowAction) - wait.ts: 智能等待 (waitSpaReady/waitTableReady/waitFormModalReady/waitRowCountChange) 不用 networkidle, 用具体元素 selector, 默认 15s (vs 30s networkidle) - nav.ts: 菜单导航 (clickMenu 精确匹配 + expandCategory) - form.ts: 表单操作 (fillByLabel/selectByLabel/fillDateByLabel/fillTextareaByLabel/ fillNumberByLabel/saveModal/closeModal) - table.ts: vxe-table 操作 (countRows/findRow/clickRowAction/getTotalText/clickAdd) - modal.ts: 模态框 (waitOpen/waitClose/getErrors/isOpen/getTitle) - index.ts: 聚合导出 - auth.ts: 已存在 (login + storageState 6h TTL) p16 spec 重构: - tests/e2e/p16-ui-real-crud.spec.ts: 226 → 180 行 (-20%) - 用 _helpers 替代内联 selector, 智能等待替代 networkidle - typecheck 通过 已知问题 (与重构无关): - tds_leave 是 webType=1 (仅表单), 无 vxe-table 列表, p16 1st test 失败 - 原版 p16 同样 fail — 测试数据配置问题, 不是 refactor 引入 后续 (Python 镜像 + tds_leave webType 修复) 留 task #22
101 lines
2.6 KiB
TypeScript
101 lines
2.6 KiB
TypeScript
/**
|
|
* _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<string | null> {
|
|
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}`,
|
|
)
|
|
}
|