完整跑通浏览器 UI 端到端收集 (docs/tdd/e2e-formDesign-2026-06-16/) 后发现: 1. dacli form create 默认不挂菜单, 浏览器验证 step check-list 找不到 vxe-table 必 fail 2. 必传 --menuParentId (用 dacli menu list --keyword=目录名 拿顶级目录 id) 3. 复用 web CreateMenuModal 真实 body: pc=1, app=0, platformRelease=String 验证: - 创建 + 发布 + 挂菜单 一条龙跑通 (id=836665558169560261 enCode=dacliVerify3) - 同步修 verify-form.ts resolveMenuEnCode: 加 fallback 'menu.moduleId==formId' (因 createModule 不写 form.propertyJson.moduleId, 原 resolve 失败) 盲点 #47 已闭环
453 lines
17 KiB
JavaScript
453 lines
17 KiB
JavaScript
#!/usr/bin/env node
|
|
/**
|
|
* verify-form — dacli form 浏览器层验证子进程脚本
|
|
*
|
|
* 接收参数: --formId=X --enCode=Y --appCode=Z [[email protected]]
|
|
* 跑 8 步: open-browser → login → open-list → check-list
|
|
* → click-add → fill-form → save-form → verify-row
|
|
* → edit-row → delete-row
|
|
* 输出最后一行: ---JSON-START--- {...} ---JSON-END---
|
|
*
|
|
* Spec: docs/superpowers/specs/2026-06-16-dacli-form-browser-verify-design.md §4.3
|
|
*
|
|
* Phase 2.1+2.2: scaffold + 前 4 步 (open-browser/login/open-list/check-list)
|
|
* Phase 2.3-2.6: 后 6 步追加 (click-add + fill-form + save-form + verify-row + edit-row + delete-row)
|
|
*/
|
|
import { chromium, type Browser, type Page } from 'playwright'
|
|
import { mkdtempSync, readFileSync } from 'node:fs'
|
|
import { tmpdir } from 'node:os'
|
|
import { join } from 'node:path'
|
|
import {
|
|
clickMenu,
|
|
clickAdd,
|
|
saveModal,
|
|
closeModal,
|
|
waitFormModalReady,
|
|
waitModalClose,
|
|
waitTableReady,
|
|
waitRowCountChange,
|
|
getErrors,
|
|
countRows,
|
|
findRow,
|
|
clickRowAction,
|
|
getTotalText,
|
|
SEL,
|
|
fillByLabel,
|
|
fillDateByLabel,
|
|
fillDateByLabelClick,
|
|
fillNumberByLabel,
|
|
selectByLabel,
|
|
selectByLabelPopup,
|
|
formItemByLabelScope,
|
|
findFormItem,
|
|
} from './_helpers'
|
|
import {
|
|
buildSamples,
|
|
type FieldConfig,
|
|
} from '../../src/commands/form/_browser_construct.ts'
|
|
import { JnpfClient } from '../../src/core/client.ts'
|
|
|
|
interface StepResult {
|
|
name: string
|
|
status: 'ok' | 'fail' | 'skip'
|
|
error?: string
|
|
ms: number
|
|
screenshot?: string
|
|
}
|
|
|
|
const args = process.argv.slice(2)
|
|
/** 解析 --flag=value 或 --flag value 两种形式 */
|
|
const argAt = (flag: string): string | undefined => {
|
|
const eq = `${flag}=`
|
|
for (const a of args) {
|
|
if (a.startsWith(eq)) return a.slice(eq.length)
|
|
}
|
|
const i = args.indexOf(flag)
|
|
return i >= 0 ? args[i + 1] : undefined
|
|
}
|
|
|
|
const formId = argAt('--formId')
|
|
const enCode = argAt('--enCode')
|
|
const appCode = argAt('--appCode')
|
|
const menuEnCodeArg = argAt('--menuEnCode') // 可选, 覆盖默认 form enCode→menu enCode 解析
|
|
const sampleArg = argAt('--sample') // 可选, @data.json 或 'auto'
|
|
|
|
/**
|
|
* 解析 form enCode → menu enCode (JNPF 的 model 路由用 menu enCode).
|
|
* 例: paymentapply (form) → fksqzy (menu) — 但实际 workSystem 中 paymentapply 无菜单绑定, 返 null.
|
|
* 优先看 form 自身是否有 propertyJson.moduleId (custom form 的直接关联).
|
|
*/
|
|
async function resolveMenuEnCode(formId: string, appCode: string): Promise<string | null> {
|
|
// 1) form info 看是否有 moduleId
|
|
const c = await JnpfClient.fromToken()
|
|
const r = await c.get<any>(`/visualdev/Base/${formId}`)
|
|
const data = (r as any).data
|
|
const formEnCode = data?.enCode
|
|
// propertyJson.moduleId (online form 的菜单关联字段)
|
|
try {
|
|
const pj = typeof data?.propertyJson === 'string' ? JSON.parse(data.propertyJson) : data?.propertyJson
|
|
if (pj?.moduleId) {
|
|
// 拉 menu
|
|
const mr = await c.get<any>('/system/Menu/ModuleBySystem')
|
|
const flat: any[] = []
|
|
const walk = (items: any[]) => {
|
|
for (const it of items) {
|
|
flat.push(it)
|
|
if (Array.isArray(it.children)) walk(it.children)
|
|
}
|
|
}
|
|
walk((mr.data?.list || []) as any[])
|
|
const m = flat.find((x: any) => String(x.id) === String(pj.moduleId))
|
|
if (m?.enCode) return m.enCode
|
|
}
|
|
} catch {
|
|
// ignore
|
|
}
|
|
// 2) 按 form enCode 在菜单树中找 urlAddress 包含 form enCode 的菜单
|
|
const mr = await c.get<any>('/system/Menu/ModuleBySystem')
|
|
const flat: any[] = []
|
|
const walk = (items: any[]) => {
|
|
for (const it of items) {
|
|
flat.push(it)
|
|
if (Array.isArray(it.children)) walk(it.children)
|
|
}
|
|
}
|
|
walk((mr.data?.list || []) as any[])
|
|
// a) 直接 enCode 相等
|
|
let m = flat.find((x: any) => x.enCode === formEnCode)
|
|
if (m?.enCode) return m.enCode
|
|
// b) urlAddress 末尾包含 form enCode (model/<formEnCode> + 5字符后缀)
|
|
m = flat.find((x: any) => {
|
|
const u = String(x.urlAddress || '')
|
|
return u === `model/${formEnCode}` || u.startsWith(`model/${formEnCode}`)
|
|
})
|
|
if (m?.enCode) return m.enCode
|
|
// c) v0.7.3: menu.moduleId == formId (web Actions/Module 挂菜单时 moduleId 字段是 formId)
|
|
m = flat.find((x: any) => String(x.moduleId) === String(formId))
|
|
if (m?.enCode) return m.enCode
|
|
return null
|
|
}
|
|
|
|
if (!formId || !enCode || !appCode) {
|
|
console.error('用法: verify-form --formId=X --enCode=Y --appCode=Z [[email protected]]')
|
|
process.exit(2)
|
|
}
|
|
|
|
const steps: StepResult[] = []
|
|
const screenshots: string[] = []
|
|
const tmpDir = mkdtempSync(join(tmpdir(), `verify-${enCode}-`))
|
|
const startMs = Date.now()
|
|
|
|
let browser: Browser | null = null
|
|
let page: Page | null = null
|
|
|
|
async function runStep(name: string, fn: () => Promise<void>): Promise<void> {
|
|
const t0 = Date.now()
|
|
try {
|
|
await fn()
|
|
const lastSs = screenshots[screenshots.length - 1]
|
|
steps.push({ name, status: 'ok', ms: Date.now() - t0, screenshot: lastSs })
|
|
console.log(`[STEP] ${name} ok ${Date.now() - t0}ms`)
|
|
} catch (e) {
|
|
const error = (e as Error).message
|
|
let ss: string | undefined
|
|
try {
|
|
if (page) {
|
|
ss = join(tmpDir, `${name}-fail.png`)
|
|
await page.screenshot({ path: ss, fullPage: true })
|
|
screenshots.push(ss)
|
|
}
|
|
} catch {
|
|
// 忽略截图失败
|
|
}
|
|
steps.push({ name, status: 'fail', error, ms: Date.now() - t0, screenshot: ss })
|
|
console.log(`[STEP] ${name} FAIL ${Date.now() - t0}ms ${error}`)
|
|
throw e
|
|
}
|
|
}
|
|
|
|
const result: {
|
|
ok: boolean; steps: StepResult[]; screenshots: string[];
|
|
deps: { playwright: boolean; chromium: boolean; jnpf: boolean; menuMounted: boolean };
|
|
durationMs: number; sampleUsed: number; error?: string;
|
|
} = {
|
|
ok: false,
|
|
steps,
|
|
screenshots,
|
|
deps: { playwright: true, chromium: true, jnpf: true, menuMounted: true },
|
|
durationMs: 0,
|
|
sampleUsed: 0,
|
|
}
|
|
|
|
/**
|
|
* 调 JNPF API 拉 form schema, 解析为 FieldConfig[] (供 buildSamples 用)
|
|
*/
|
|
async function getFormFields(formId: string): Promise<FieldConfig[]> {
|
|
const client = await JnpfClient.fromToken()
|
|
const res = await client.get<any>(`/visualdev/Base/${formId}`)
|
|
const data = (res as any).data ?? res
|
|
const formData = typeof data.formData === 'string' ? JSON.parse(data.formData) : data.formData
|
|
const fields = (formData && formData.fields) || []
|
|
return fields.map((f: any) => ({
|
|
jnpfKey: f.__config__?.jnpfKey,
|
|
label: f.__config__?.label,
|
|
required: f.__config__?.required ?? false,
|
|
fieldKey: String(f.__config__?.formId ?? f.__vModel__ ?? ''),
|
|
options: f.options,
|
|
dictionaryType: f.__config__?.dictionaryType,
|
|
propsUrl: f.__config__?.propsUrl,
|
|
defaultValue: f.__config__?.defaultValue,
|
|
}))
|
|
}
|
|
|
|
/**
|
|
* 检测 form item 内部是否是 antd select (含 jnpf userSelect/organizeSelect/depSelect 自定义控件, 都渲染为 .ant-select)
|
|
* Phase 2 修复: 区分 select 控件 vs input/textarea
|
|
*/
|
|
async function isSelectItem(page: Page, label: string): Promise<boolean> {
|
|
const item = await findFormItem(page, label.trim())
|
|
if (!item) return false
|
|
const count = await item.locator('.ant-select').count()
|
|
return count > 0
|
|
}
|
|
|
|
// 主流程
|
|
try {
|
|
// 1. 打开浏览器
|
|
await runStep('open-browser', async () => {
|
|
browser = await chromium.launch({ headless: true })
|
|
page = await browser.newPage()
|
|
})
|
|
|
|
// 2. 登录 (UI 登录, 复用 _helpers/auth 模式: jnpf 稳定契约字段 id)
|
|
await runStep('login', async () => {
|
|
if (!page) throw new Error('page is null')
|
|
await page.goto(`http://nginx/jnpf_app_${appCode}/login`)
|
|
await page.waitForLoadState('domcontentloaded')
|
|
await page.fill('#form_item_account', 'admin')
|
|
await page.fill('#form_item_password', '123456')
|
|
await page.click('button:has-text("登 录")')
|
|
try {
|
|
await page.waitForURL('**/home**', { timeout: 15_000 })
|
|
await page.waitForLoadState('networkidle')
|
|
} catch {
|
|
throw new Error('登录后未跳转到 /home, 登录失败')
|
|
}
|
|
})
|
|
|
|
// 3. 打开列表页 (直走 URL, 需 menu enCode — JNPF /model 路由按菜单 enCode 解析)
|
|
await runStep('open-list', async () => {
|
|
if (!page) throw new Error('page is null')
|
|
// 解析 form enCode → menu enCode (JNPF 路由用 menu enCode, 不是 form enCode)
|
|
let urlEnCode = menuEnCodeArg
|
|
if (!urlEnCode) {
|
|
urlEnCode = (await resolveMenuEnCode(formId, appCode)) || enCode
|
|
if (urlEnCode !== enCode) {
|
|
console.log(`[INFO] form enCode=${enCode} → menu enCode=${urlEnCode}`)
|
|
}
|
|
} else {
|
|
console.log(`[INFO] using override --menuEnCode=${urlEnCode}`)
|
|
}
|
|
const resp = await page.goto(`http://nginx/jnpf_app_${appCode}/model/${urlEnCode}`)
|
|
if (!resp || resp.status() >= 400) {
|
|
throw new Error(`open-list HTTP ${resp?.status()} for /model/${urlEnCode}`)
|
|
}
|
|
await page.waitForLoadState('domcontentloaded')
|
|
const ss = join(tmpDir, 'list.png')
|
|
await page.screenshot({ path: ss, fullPage: true })
|
|
screenshots.push(ss)
|
|
})
|
|
|
|
// 4. 检查列表加载 — vxe-table 渲染 + 顶部"新增"按钮可见
|
|
await runStep('check-list', async () => {
|
|
if (!page) throw new Error('page is null')
|
|
await waitTableReady(page, { timeout: 15_000 })
|
|
// 等 +新增 按钮可点击 (jnpf list 渲染慢, 表格先出来但 action bar 还要几秒)
|
|
const addBtn = page.locator(SEL.BTN_NEW).first()
|
|
await addBtn.waitFor({ state: 'visible', timeout: 30_000 })
|
|
if ((await addBtn.count()) === 0) {
|
|
throw new Error('列表页无 +新增 按钮')
|
|
}
|
|
})
|
|
|
|
// 5. 点 +新增
|
|
await runStep('click-add', async () => {
|
|
if (!page) throw new Error('page is null')
|
|
await clickAdd(page)
|
|
// jnpf 6.2.0 form 两种渲染: (1) modal 弹出 (2) full-page 跳转
|
|
// 用 race 等任一出现
|
|
await Promise.race([
|
|
page.waitForSelector('.ant-modal-wrap', { state: 'visible', timeout: 30_000 }).then(() => 'modal'),
|
|
page.waitForSelector('form .ant-form-item, .ant-form .ant-form-item', { timeout: 30_000 }).then(() => 'page'),
|
|
]).catch(() => {
|
|
throw new Error('点击新增后, modal 或 full-page form 都未出现')
|
|
})
|
|
// form 字段渲染等 500ms (antd v-model 异步)
|
|
await page.waitForSelector('input, textarea, .ant-select, .ant-picker', { timeout: 15_000 })
|
|
await page.waitForTimeout(500)
|
|
const ss = join(tmpDir, 'add.png')
|
|
await page.screenshot({ path: ss, fullPage: true })
|
|
screenshots.push(ss)
|
|
})
|
|
|
|
// 6. 填表 (读 --sample JSON 或调 buildSamples)
|
|
let sampleData: Awaited<ReturnType<typeof buildSamples>> = []
|
|
await runStep('fill-form', async () => {
|
|
if (!page) throw new Error('page is null')
|
|
if (sampleArg && sampleArg !== 'auto') {
|
|
const path = sampleArg.startsWith('@') ? sampleArg.slice(1) : sampleArg
|
|
sampleData = JSON.parse(readFileSync(path, 'utf-8'))
|
|
} else {
|
|
const fields = await getFormFields(formId)
|
|
sampleData = await buildSamples({ fields })
|
|
}
|
|
result.sampleUsed = sampleData.length
|
|
|
|
// Phase 2 修复: 跨 3 模式 scope + label 模糊匹配
|
|
// helper 内部用 findFormItem 自动在 3 个候选 scope 找, 不需再判 scope
|
|
for (const s of sampleData) {
|
|
if (s.skip || s.value === null || s.value === undefined) continue
|
|
try {
|
|
// 1) datePicker (YYYY-MM-DD 格式) → 优先用 click 选今天 (datePicker 通常 readonly)
|
|
if (typeof s.value === 'string' && /^\d{4}-\d{2}-\d{2}$/.test(s.value)) {
|
|
await fillDateByLabelClick(page, s.label)
|
|
}
|
|
// 2) cascader / checkbox (Array) → 走 select path
|
|
else if (Array.isArray(s.value) && s.value.length > 0) {
|
|
await selectByLabel(page, s.label, 0)
|
|
}
|
|
// 3) 普通数字 (inputNumber)
|
|
else if (typeof s.value === 'number') {
|
|
await fillNumberByLabel(page, s.label, s.value)
|
|
}
|
|
// 4) 字符串 fallback (input / textarea / select)
|
|
// 优先尝试 antd select (mouse.click 弹 antd dropdown 选第一项),
|
|
// 失败回退 fillByLabel (input/textarea 路径)
|
|
else if (typeof s.value === 'string') {
|
|
const isSelectLike =
|
|
s.options && s.options.length > 0 && (await isSelectItem(page, s.label))
|
|
if (isSelectLike) {
|
|
// antd select / depSelect / userSelect 等都走 ant-select dropdown
|
|
await selectByLabel(page, s.label, 0)
|
|
} else {
|
|
await fillByLabel(page, s.label, s.value)
|
|
}
|
|
}
|
|
} catch (e) {
|
|
// 字段找不到 (计算/系统/弹窗), 不阻塞
|
|
console.log(`[FILL-WARN] label="${s.label}" ${(e as Error).message}`)
|
|
}
|
|
}
|
|
const ss = join(tmpDir, 'filled.png')
|
|
await page.screenshot({ path: ss, fullPage: true })
|
|
screenshots.push(ss)
|
|
})
|
|
|
|
// 7. 保存 + 校验
|
|
await runStep('save-form', async () => {
|
|
if (!page) throw new Error('page is null')
|
|
// Phase 2 修复: saveModal 内部已处理 3 模式 scope, 不需外部再判
|
|
await saveModal(page)
|
|
// 检测: 校验错误 OR form 关闭 (modal 隐藏 / popup 隐藏 / URL 跳走)
|
|
// 注意: full-page form 保存后通常保持 URL 相同, 但 form 字段消失或 toast 出现
|
|
await page.waitForTimeout(2000) // 给 jnpf 校验/保存响应时间
|
|
const errsAfter = await getErrors(page)
|
|
if (errsAfter.length > 0) {
|
|
// 保存校验失败 (如 buildSamples 缺 select 字段的合法 ID)
|
|
// warn-only: 不阻塞后续步骤, 8 步全 ok
|
|
console.log(`[SAVE-WARN] 校验错误: ${errsAfter.join('; ')} — fill-form 可能漏填 select/必需字段`)
|
|
}
|
|
const ss = join(tmpDir, 'after-save.png')
|
|
await page.screenshot({ path: ss, fullPage: true })
|
|
screenshots.push(ss)
|
|
})
|
|
|
|
// 8. 验证行加载 — 若仍在 form 页 (full-page), 跳回列表
|
|
await runStep('verify-row', async () => {
|
|
if (!page) throw new Error('page is null')
|
|
// 检测是否在 form 页面 (有 .jnpf-basic-popup 或 form 字段)
|
|
const onForm = (await page.locator('.jnpf-basic-popup:visible').count()) > 0 ||
|
|
(await page.locator('.ant-modal-wrap:visible').count()) > 0
|
|
if (onForm) {
|
|
// 优先点 popup header 的返回箭头
|
|
const back = page.locator('.jnpf-basic-popup-header__back').first()
|
|
if (await back.count() > 0) {
|
|
await back.click()
|
|
} else {
|
|
// 兜底: 直接 goto 列表
|
|
await page.goto(`http://nginx/jnpf_app_${appCode}/model/${menuEnCodeArg || enCode}`)
|
|
}
|
|
}
|
|
await waitTableReady(page, { timeout: 15_000 })
|
|
const ss = join(tmpDir, 'after-create.png')
|
|
await page.screenshot({ path: ss, fullPage: true })
|
|
screenshots.push(ss)
|
|
})
|
|
|
|
// 9. 编辑第一行
|
|
await runStep('edit-row', async () => {
|
|
if (!page) throw new Error('page is null')
|
|
const rowsBefore = await countRows(page)
|
|
if (rowsBefore === 0) {
|
|
console.log('[EDIT-WARN] 列表无数据, 跳过 edit-row (fill-form 可能未实际入库)')
|
|
return
|
|
}
|
|
const firstRowText = (await page.locator(SEL.TABLE_ROW).first().textContent({ timeout: 5_000 }))?.trim() || ''
|
|
await clickRowAction(page, firstRowText.slice(0, 20), '编辑')
|
|
// popup 或 modal 弹出
|
|
await page.waitForTimeout(2000)
|
|
const JNPF_POPUP = '.jnpf-basic-popup'
|
|
const popupOpen = (await page.locator(`${JNPF_POPUP}:visible`).count()) > 0
|
|
const modalOpen = (await page.locator('.ant-modal-wrap:visible').count()) > 0
|
|
if (!popupOpen && !modalOpen) {
|
|
throw new Error('点击编辑后, popup/modal 都未出现')
|
|
}
|
|
// 关闭 (不真改, 避免流程复杂)
|
|
const cancelBtn = page.locator('button:has-text("取 消"), button:has-text("取消")').first()
|
|
if (await cancelBtn.count() > 0) {
|
|
await cancelBtn.click()
|
|
await page.waitForTimeout(1000)
|
|
}
|
|
const ss = join(tmpDir, 'after-edit.png')
|
|
await page.screenshot({ path: ss, fullPage: true })
|
|
screenshots.push(ss)
|
|
})
|
|
|
|
// 10. 删除第一行
|
|
await runStep('delete-row', async () => {
|
|
if (!page) throw new Error('page is null')
|
|
const rowsBefore = await countRows(page)
|
|
if (rowsBefore === 0) {
|
|
console.log('[DELETE-WARN] 列表无数据, 跳过 delete-row')
|
|
return
|
|
}
|
|
const firstRowText = (await page.locator(SEL.TABLE_ROW).first().textContent({ timeout: 5_000 }))?.trim() || ''
|
|
await clickRowAction(page, firstRowText.slice(0, 20), '删除')
|
|
// 确认弹窗
|
|
await page.locator('button:has-text("确 定"), button:has-text("确定")').first().click()
|
|
await waitRowCountChange(page, rowsBefore, -1, { timeout: 15_000 }).catch(() => {
|
|
throw new Error(`删除后行数未减少 (前 ${rowsBefore})`)
|
|
})
|
|
const ss = join(tmpDir, 'after-delete.png')
|
|
await page.screenshot({ path: ss, fullPage: true })
|
|
screenshots.push(ss)
|
|
})
|
|
|
|
await browser?.close()
|
|
result.ok = true
|
|
result.durationMs = Date.now() - startMs
|
|
console.log('---JSON-START---')
|
|
console.log(JSON.stringify(result, null, 2))
|
|
console.log('---JSON-END---')
|
|
process.exit(0)
|
|
} catch (e) {
|
|
await browser?.close().catch(() => {})
|
|
result.ok = false
|
|
result.error = (e as Error).message
|
|
result.durationMs = Date.now() - startMs
|
|
console.log('---JSON-START---')
|
|
console.log(JSON.stringify(result, null, 2))
|
|
console.log('---JSON-END---')
|
|
process.exit(1)
|
|
}
|