- _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]>
133 lines
4.8 KiB
TypeScript
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}")`,
|
|
);
|