Files
dacli/tests/e2e/verify-form.ts
T
ssw 7b16fd941d form create: 加 --autoCreateMenu 选项 (盲点 47)
完整跑通浏览器 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 已闭环
2026-06-16 20:31:14 +08:00

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