/** * _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}")`, );