Files
dacli/tests/e2e/_helpers/wait.ts
T
ssw 7cc1fb62bc v17: JNPF 浏览器验证标准库 (_helpers/) + p16 重构
标准库 (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
2026-06-15 13:05:39 +08:00

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}`,
)
}