@epoint-testtech/ep-stage-skill 0.0.10 → 0.5.0-alpha.2

package/codex-skill/ep-stage/page-element-scan/scripts/extract-page-elements.mjs

@@ -1,298 +0,0 @@
-/**
- * extract-page-elements.mjs
- *
- * 可在浏览器上下文直接运行的 DOM 扫描内核（无外部依赖）。
- * 用途：
- *   1. 被 scan-page.mjs import 复用扫描逻辑
- *   2. 被 playwright-cli eval "<call>" 注入到已有 session 中实时采集 element map
- *
- * playwright-cli eval 使用示例（主 frame）：
- *   playwright-cli -s=$SESSION eval "< $(cat extract-page-elements.mjs) ; print(JSON.stringify(extractPageElements()))"
- *
- * playwright-cli eval 使用示例（遍历所有 frame）：
- *   playwright-cli -s=$SESSION eval "< $(cat extract-page-elements.mjs) ; print(JSON.stringify(extractAllFramesElementMap()))"
- *
- * 导出函数签名：
- *   extractPageElements()           -> { title, elements[] }          当前 frame 扫描
- *   extractAllFramesElementMap()    -> { [label]: { locator, controlType, visible } }  所有 frame 聚合
- */
-
-/**
- * 单 frame 扫描内核（与 scan-page.mjs 内部逻辑保持同步）。
- */
-function extractPageElements() {
-  const norm = (s) => (s || '').replace(/\s+/g, ' ').trim();
-
-  function isVisible(el) {
-    const style = window.getComputedStyle(el);
-    if (style.display === 'none' || style.visibility === 'hidden') return false;
-    const rect = el.getBoundingClientRect();
-    return rect.width > 0 && rect.height > 0;
-  }
-
-  function isEnabled(el) {
-    const cls = el.className || '';
-    return !el.disabled
-      && el.getAttribute('aria-disabled') !== 'true'
-      && !String(cls).includes('mini-disabled')
-      && !String(cls).includes('disabled');
-  }
-
-  function fieldLabel(el) {
-    // 分页控件（页码输入框、页面尺寸下拉框）：不在表单字段采集范围内
-    if (el.classList.contains('pagination-number')) return '';
-    if (el.closest('.mini-pagination, .pagination-pagerchange')) return '';
-    const wrapper = el.closest('[label]');
-    if (wrapper) return norm(wrapper.getAttribute('label'));
-    if (el.getAttribute('aria-label')) return norm(el.getAttribute('aria-label'));
-    if (el.id) {
-      const lab = document.querySelector(`label[for="${el.id}"]`);
-      if (lab) return norm(lab.innerText);
-    }
-    const containerLabel = el.closest('div, td')?.querySelector('label');
-    if (containerLabel) return norm(containerLabel.innerText).replace(/[:：]$/, '');
-    const prev = el.closest('td, div')?.previousElementSibling;
-    if (prev && /label|td/.test(prev.tagName.toLowerCase())) return norm(prev.innerText).replace(/[:：]$/, '');
-    return norm(el.placeholder || el.getAttribute('bind') || el.name || el.id || '').replace(/^[　 ]+|[　 ]+$/g, '') || '';
-  }
-
-  function controlType(el) {
-    const cls = String(el.className || '');
-    const mini = cls.match(/mini-[a-z]+/);
-    if (mini) return mini[0];
-    if (el.tagName === 'SELECT') return 'html-select';
-    if (el.tagName === 'TEXTAREA') return 'html-textarea';
-    return `html-${el.type || 'input'}`;
-  }
-
-  function hiddenInputLocator(el, label) {
-    const itemDiv = el.closest('.mini-radiobuttonlist-item, .mini-checkbox');
-    if (itemDiv && itemDiv.id) return `#${CSS.escape(itemDiv.id)}`;
-    if (label) {
-      const type = el.type === 'radio' ? 'mini-radiobuttonlist-item' : 'mini-checkbox';
-      return `xpath=//div[contains(@class,'${type}')][normalize-space()='${label}']`;
-    }
-    return null;
-  }
-
-  function fieldLocator(el, label) {
-    const type = controlType(el);
-    const tag = el.tagName.toLowerCase();
-    if (label && type.startsWith('mini-')) {
-      const exact = `xpath=//div[@label='${label}']//${tag}[contains(@class,'${type}') or contains(@class,'${type}-input')]`;
-      if (document.querySelector(`div[label='${label}']`)) return exact;
-      const bareLabel = label.replace(/\d+/g, '').replace(/\s+/g, ' ').trim();
-      return `xpath=//div[@label and contains(@label,'${bareLabel.replace(/[^一-龥a-zA-Z]/g, '')}')]//${tag}[contains(@class,'${type}') or contains(@class,'${type}-input')]`;
-    }
-    if (el.id) {
-      if (el.id.includes('$')) {
-        const prev = hiddenInputLocator(el, label);
-        if (prev) return prev;
-      }
-      return `#${CSS.escape(el.id)}`;
-    }
-    if (el.name) return `${tag}[name="${el.name}"]`;
-    if (label) return `xpath=//div[@label='${label}']//${tag}`;
-    return tag;
-  }
-
-  function buttonLocator(el, label) {
-    const tag = el.tagName.toLowerCase();
-    const cls = String(el.className || '');
-    if (cls.includes('mini-button')) return `xpath=//${tag}[contains(@class,'mini-button')][normalize-space()='${label}']`;
-    if (cls.includes('cond-srh-btn')) return `xpath=//a[contains(@class,'cond-srh-btn')][normalize-space()='${label}']`;
-    if (el.id) return `#${el.id}`;
-    return `role=button[name="${label}"]`;
-  }
-
-  const elements = [];
-  const seen = new Set();
-  function push(el) {
-    const key = `${el.type}|${el.label}|${el.locator}`;
-    if (seen.has(key)) return;
-    seen.add(key);
-    elements.push(el);
-  }
-
-  // 按钮
-  document.querySelectorAll(
-    'a.mini-button, button, input[type=button], input[type=submit], input[type=reset], [role=button], a.cond-srh-btn, a.mini-tools, span.mini-tools',
-  ).forEach((el) => {
-    const label = norm(el.innerText || el.value || el.getAttribute('data-tooltip') || el.title || '');
-    if (!label) return;
-    push({ type: 'button', label, locator: buttonLocator(el, label), visible: isVisible(el), enabled: isEnabled(el) });
-  });
-
-  // 表单字段
-  document.querySelectorAll(
-    'input:not([type=button]):not([type=submit]):not([type=reset]):not([type=hidden]), textarea, select',
-  ).forEach((el) => {
-    if (!isVisible(el) && el.closest('.mini-textbox, .mini-combobox, .mini-datepicker, .mini-spinner')) return;
-    if ((el.type === 'radio' || el.type === 'checkbox') && !isVisible(el)) return;
-    const label = fieldLabel(el);
-    if (!label) return;
-    push({
-      type: 'field', label, controlType: controlType(el),
-      locator: fieldLocator(el, label),
-      visible: isVisible(el), enabled: isEnabled(el),
-      required: el.required || el.getAttribute('required') === 'true' || !!el.closest('.starred, [starred]'),
-    });
-  });
-
-  // MiniUI RadioButtonList / CheckBox 独立控件（父 div 可点击）
-  document.querySelectorAll('.mini-radiobuttonlist-item, .mini-checkbox').forEach((el) => {
-    const input = el.querySelector('input[type=radio], input[type=checkbox]');
-    if (!input) return;
-    let label = norm(input.labels?.[0]?.innerText || el.innerText || '').replace(/[:：]$/, '');
-    if (!label) return;
-    const numInput = el.querySelector('.mini-export-num');
-    if (numInput) label = label.replace(/\d+/g, '');
-    const isRadio = input.type === 'radio';
-    const itemId = el.id;
-    const locator = itemId ? `#${CSS.escape(itemId)}`
-      : `xpath=//div[contains(@class,'${isRadio ? 'mini-radiobuttonlist-item' : 'mini-checkbox'})][contains(normalize-space(),'${label}')]`;
-    push({ type: 'field', label, controlType: isRadio ? 'mini-radiobuttonlist' : 'mini-checkbox', locator, visible: isVisible(el), enabled: isEnabled(el) });
-  });
-
-  // 列表
-  document.querySelectorAll('.mini-datagrid').forEach((grid) => {
-    const gridId = grid.id || 'datagrid';
-    const headers = [...grid.querySelectorAll('.mini-grid-headertxt, .mini-grid-headerText, th')].map((h) => norm(h.innerText)).filter(Boolean);
-    const rowActions = [...grid.querySelectorAll('[data-tooltip]')].map((a) => norm(a.getAttribute('data-tooltip'))).filter(Boolean);
-    push({ type: 'grid', label: gridId, locator: `#${gridId}`, visible: isVisible(grid), enabled: true, columns: headers, rowActions: [...new Set(rowActions)] });
-  });
-
-  // 标签页
-  document.querySelectorAll('.mini-tabs li, [role=tab]').forEach((el) => {
-    const label = norm(el.innerText);
-    if (!label) return;
-    push({ type: 'tab', label, locator: `role=tab[name="${label}"]`, visible: isVisible(el), enabled: isEnabled(el) });
-  });
-
-  // 普通链接
-  document.querySelectorAll('a[href]:not(.mini-button)').forEach((el) => {
-    const label = norm(el.innerText);
-    if (!label || !isVisible(el)) return;
-    push({ type: 'link', label, locator: `role=link[name="${label}"]`, visible: true, enabled: isEnabled(el), href: el.getAttribute('href') });
-  });
-
-  // MiniUI 分页控件
-  document.querySelectorAll('.mini-grid-pager').forEach((pager) => {
-    // 确定所属 grid 的 id
-    const parentGrid = pager.closest('.mini-datagrid');
-    const gridId = parentGrid?.id || 'datagrid';
-    const prefix = parentGrid ? `#${CSS.escape(gridId)}` : '';
-
-    // 总条数文本
-    const pagerInfo = pager.querySelector('.pagination-pagerinfo');
-    if (pagerInfo) {
-      const label = norm(pagerInfo.innerText); // 如 "共536条"
-      push({ type: 'pagination', label, locator: `${prefix} .pagination-pagerinfo`, visible: true, enabled: true });
-    }
-
-    // 分页按钮组
-    const btns = pager.querySelectorAll('.pagination-buttons a');
-    btns.forEach((btn) => {
-      const action = btn.getAttribute('action');
-      const isEllipsis = btn.classList.contains('pagination-button-ellipsis');
-      let label = norm(btn.innerText) || '';
-      let subType = '';
-      let locatorSuffix = '';
-
-      if (action === 'prev') {
-        subType = 'pagination-prev';
-        label = '上一页';
-        locatorSuffix = `.pagination-buttons a[action=prev]`;
-      } else if (action === 'next') {
-        subType = 'pagination-next';
-        label = '下一页';
-        locatorSuffix = `.pagination-buttons a[action=next]`;
-      } else if (action === 'none' || isEllipsis) {
-        subType = 'pagination-ellipsis';
-        label = '...';
-        locatorSuffix = `.pagination-button-ellipsis`;
-      } else {
-        // 页码数字按钮
-        subType = 'pagination-page';
-        label = norm(btn.innerText); // "1", "2", "49"
-        locatorSuffix = `.pagination-buttons a.pagination-button:not(.pagination-button-ellipsis)`;
-      }
-      push({
-        type: 'pagination',
-        subType,
-        label,
-        locator: `${prefix} ${locatorSuffix}`,
-        visible: isVisible(btn),
-        enabled: !btn.classList.contains('disabled'),
-      });
-    });
-
-    // 页面尺寸下拉（只采集可见的）
-    const pageSizeBtn = pager.querySelector('.mini-pagination > span.mini-buttonedit');
-    if (pageSizeBtn && isVisible(pageSizeBtn)) {
-      const hiddenVal = pageSizeBtn.querySelector('input[type=hidden]');
-      push({
-        type: 'pagination',
-        subType: 'pagination-size',
-        label: '页面尺寸',
-        locator: `${prefix} .mini-pagination > span.mini-buttonedit`,
-        value: hiddenVal?.value || '',
-        visible: true,
-        enabled: true,
-      });
-    }
-
-    // 页码跳转输入框
-    const jumpInput = pager.querySelector('.pagination-pagerchange input.pagination-number');
-    if (jumpInput && isVisible(jumpInput)) {
-      push({
-        type: 'pagination',
-        subType: 'pagination-jump',
-        label: '跳至页',
-        locator: `${prefix} .pagination-pagerchange input.pagination-number`,
-        visible: true,
-        enabled: isEnabled(jumpInput),
-      });
-    }
-  });
-
-  return { title: document.title, elements };
-}
-
-/**
- * 遍历所有 frame（含子 iframe），对每个 frame 执行 extractPageElements()，
- * 聚合所有 elements，去重后以 { label → { locator, controlType, visible } } 返回。
- * 专供 playwright-cli eval 在 O-D-A-V Act 之后使用：捕获弹窗/子表等动态新增元素。
- */
-function extractAllFramesElementMap() {
-  const result = {};
-  // 主 frame
-  try {
-    const main = extractPageElements();
-    for (const el of main.elements) {
-      if (!result[el.label] || el.visible) result[el.label] = { locator: el.locator, controlType: el.controlType, visible: el.visible };
-    }
-  } catch (_) {}
-
-  // 子 frame（通过 window.frames 枚举）
-  try {
-    for (let i = 0; i < window.frames.length; i++) {
-      const fr = window.frames[i];
-      try {
-        const r = fr.extractPageElements ? fr.extractPageElements() : null;
-        if (!r) continue;
-        for (const el of r.elements) {
-          if (!result[el.label] || el.visible) result[el.label] = { locator: el.locator, controlType: el.controlType, visible: el.visible };
-        }
-      } catch (_) { /* 跨域 frame 跳过 */ }
-    }
-  } catch (_) {}
-
-  return result;
-}
-
-// Node.js 环境：CommonJS 导出（被 scan-page.mjs import）
-// 浏览器 / playwright-cli eval 环境：全局函数直接可用
-if (typeof module !== 'undefined' && module.exports) {
-  module.exports = { extractPageElements, extractAllFramesElementMap };
-}