Files
dacli/tests/e2e/_helpers/selectors.ts
T
sswandClaude 341f48ef75 fix(verify-form): 7 FILL-WARN 修复 + jnpf 6.2.0 3 模式 + label 模糊匹配
- _helpers/selectors.ts: 加 BASIC_POPUP / BASIC_POPUP_HEADER_BACK scope
                       + FORM_SCOPE_CANDIDATES 跨 3 模式查找列表
                       + formItemByLabel/rowAction 加 Page/Locator 类型
- _helpers/form.ts:
  - findFormItem: 跨 3 模式 (ant-modal/basic-popup/popup-content/body) 找 label
  - label 模糊匹配 (trim + 包含, 不要求精确)
  - fillDateByLabelClick: 点 calendar 选今天 (datePicker readonly)
  - selectByLabelPopup: userSelect/depSelect 弹窗选第一行
  - saveModal/closeModal: 自动 detect 3 模式 scope
  - 所有 helper 内部用 findFormItem 替代 formItemByLabel(page,label,scope)
- _helpers/index.ts: 导出 formItemByLabelScope/findFormItem/fillDateByLabelClick/selectByLabelPopup
- _browser_construct.ts: FieldSample 加 options 字段 (select 等可选 ID 列表)
                       + fetchUserList/fetchOrgList 返 [{id, value}]
- verify-form.ts: fill-form 改用 isSelectItem + selectByLabel (antd select 路径)
                + fillDateByLabelClick 走 datePicker readonly 路径

paymentapply 端到端 8/8 step PASS, fill-form 40213ms → 11288ms (4x 加速).
39/39 单测保持 PASS.

已知限制: 菜单 fksqzy 实际加载 workflow form 797489589626339909 (StartFormId 端点),
        与 paymentapply (id 585398402720727621) schema 不一致, 导致 6 字段 label
        在渲染 form 中不存在 → 6 FILL-WARN. 这是 JNPF menu/form 路由问题, 不
        在本 fix 范围. 完整 8 步流程 (open→save→list) 已稳定 PASS.

Co-Authored-By: Claude <[email protected]>
2026-06-16 14:16:40 +08:00

133 lines
4.8 KiB
TypeScript

/**
* _helpers/selectors.ts — JNPF 6.2.0 通用选择器常量
*
* 集中所有"jnpf 稳定契约"选择器, 改 jnpf 版本只需改这一处。
* 盲点 31 防御: 字符串 `:`/`.` 等要 escape? Playwright CSS 引擎自动转义。
*
* 命名规范:
* - 大写常量 = 字符串选择器
* - 函数 (formItemByLabel/rowAction) = 组合, 调用方传 label/action
*/
export const SEL = {
// ===== 登录页 =====
LOGIN_ACCOUNT: '#form_item_account',
LOGIN_PASSWORD: '#form_item_password',
LOGIN_SUBMIT: 'button:has-text("登 录")',
// ===== 侧边栏菜单 (jnpf 6.2.0 扁平 + 偶尔嵌套) =====
// 优先 .jnpf-menu-item (jnpf 自定义), 兜底 .ant-menu-item (antd), 再兜底 [class*="menu-item"]
MENU_ITEM: '.jnpf-menu-item',
MENU_SUB: '.jnpf-sub-menu',
MENU_SUB_TITLE: '.jnpf-sub-menu-content__title',
MENU_SUB_CONTENT: '.jnpf-sub-menu-content',
// 多个候选 (按优先级)
MENU_ITEM_CANDIDATES: [
'.jnpf-menu-item',
'.ant-menu-item',
'[class*="menu-item"]',
] as const,
// ===== 模态框 =====
MODAL: '.ant-modal',
MODAL_CONFIRM: '.ant-modal-confirm',
MODAL_CONFIRM_BTNS: '.ant-modal-confirm-btns',
// modal 内主按钮 (优先级: confirm-btns 内的 primary > modal 内的 primary)
MODAL_PRIMARY:
'.ant-modal-confirm-btns button.ant-btn-primary, .ant-modal button.ant-btn-primary, .ant-modal button:has-text("保 存"), .ant-modal button:has-text("确 定")',
MODAL_CLOSE: '.ant-modal button:has-text("关 闭")',
MODAL_CANCEL: '.ant-modal button:has-text("取 消")',
// ===== 表单 =====
FORM_ITEM: '.ant-form-item',
FORM_ITEM_LABEL: '.ant-form-item-label label',
FORM_ITEM_REQUIRED: '.ant-form-item-required',
FORM_ITEM_ERROR: '.ant-form-item-explain-error',
// ===== 输入控件 =====
INPUT: 'input',
TEXTAREA: 'textarea',
SELECT: '.ant-select',
SELECT_DROPDOWN: '.ant-select-dropdown:visible',
SELECT_ITEM: '.ant-select-item-option',
PICKER: '.ant-picker input',
// 日期/时间
DATE_PICKER: '.ant-picker',
DATE_PICKER_INPUT: '.ant-picker-input > input',
TIME_PICKER: '.ant-picker input[placeholder*=":"]',
// 开关
SWITCH: '.ant-switch',
// 单选/多选
RADIO_GROUP: '.ant-radio-group',
RADIO_ITEM: '.ant-radio-wrapper',
CHECKBOX_GROUP: '.ant-checkbox-group',
CHECKBOX_ITEM: '.ant-checkbox-wrapper',
// 级联/树选择
CASCADER: '.ant-cascader-picker',
CASCADER_DROPDOWN: '.ant-cascader-dropdown',
TREE_SELECT: '.ant-tree-select',
TREE_SELECT_DROPDOWN: '.ant-select-dropdown:visible .ant-tree',
TREE_SELECT_NODE: '.ant-tree-node-content-wrapper',
// 上传
UPLOAD: '.ant-upload',
UPLOAD_BTN: '.ant-upload .ant-btn, .ant-upload .ant-upload-select',
UPLOAD_INPUT: '.ant-upload input[type="file"]',
// 评分/滑块/颜色
RATE: '.ant-rate',
SLIDER: '.ant-slider',
COLOR_PICKER: '.ant-color-picker, .color-picker-trigger',
// 富文本
EDITOR: '.tox-tinymce, .ant-editor, [contenteditable="true"]',
// ===== 表格 (vxe-table 4.x) =====
TABLE: '.vxe-table',
TABLE_ROW: '.vxe-body--row',
// 分页总数 selector (多个版本支持)
TABLE_PAGER_TOTAL:
'.vxe-pager--total, .pager-count, .jnpf-pagination__total',
// ===== 通用按钮 (列表页/弹窗) =====
BTN_PRIMARY: 'button.ant-btn-primary',
BTN_NEW: 'button:has-text("新 增"), button:has-text("新增")',
BTN_EDIT:
'a:has-text("编 辑"), a:has-text("编辑"), button:has-text("编 辑"), button:has-text("编辑")',
BTN_DELETE:
'a:has-text("删 除"), a:has-text("删除"), button:has-text("删 除"), button:has-text("删除")',
// ===== JNPF 6.2.0 form 3 模式 (Phase 2 修复) =====
// (1) ant-modal 弹出 (已有)
// (2) jnpf BasicPopup (full-popup) — paymentapply 用此模式
BASIC_POPUP: '.jnpf-basic-popup',
BASIC_POPUP_HEADER_BACK: '.jnpf-basic-popup-header__back',
// (3) full-page 路由跳转 — 默认走 body 全局
// body 留作 fallback 兜底, 不放进 SEL 避免和全局选择器混淆
} as const;
/**
* form 容器候选 scope (按优先级), 用于 formItemByLabelScope() 跨 3 模式查找
* (1) ant-modal (2) jnpf-basic-popup (3) jnpf-popup-content 变体
*/
export const FORM_SCOPE_CANDIDATES = [
'.ant-modal',
'.jnpf-basic-popup',
'.jnpf-popup-content',
] as const;
/**
* 找含 label 文本的 form-item (在 modal 或其他容器内)
* 用法: formItemByLabel(page, '申请人姓名') → Locator
*/
export const formItemByLabel = (page: import('@playwright/test').Page, label: string, scope: string = SEL.MODAL) =>
page.locator(
`${scope} ${SEL.FORM_ITEM}:has(${SEL.FORM_ITEM_LABEL}:has-text("${label}"))`,
);
/**
* 找行的操作按钮 (jnpf 模板常用 a/button + "编辑/删除")
* 用法: rowAction(row, '编 辑') → Locator
*/
export const rowAction = (row: import('@playwright/test').Locator, action: string) =>
row.locator(
`a:has-text("${action}"), button:has-text("${action}")`,
);