@midscene/shared 0.17.2 → 0.17.3-beta-20250526042111.0

package/dist/lib/extractor.js

@@ -197,6 +197,9 @@ function isFormElement(node) {
 function isButtonElement(node) {
   return node instanceof HTMLElement && node.tagName.toLowerCase() === "button";
 }
+function isAElement(node) {
+  return node instanceof HTMLElement && node.tagName.toLowerCase() === "a";
+}
 function isImgElement(node) {
   if (!includeBaseElement(node) && node instanceof Element) {
     const computedStyle = window.getComputedStyle(node);
@@ -247,7 +250,8 @@ function includeBaseElement(node) {
     "textarea",
     "select",
     "option",
-    "img"
+    "img",
+    "a"
   ];
   for (const tagName of includeList) {
     const element = node.querySelectorAll(tagName);
@@ -636,10 +640,20 @@ function collectElementInfo(node, currentWindow, currentDocument, baseZoom = 1,
     return elementInfo;
   }
   if (isButtonElement(node)) {
+    const rect2 = mergeElementAndChildrenRects(
+      node,
+      currentWindow,
+      currentDocument,
+      baseZoom,
+      visibleOnly
+    );
+    if (!rect2) {
+      return null;
+    }
     const attributes = getNodeAttributes(node, currentWindow);
     const pseudo = getPseudoElementContent(node, currentWindow);
     const content = node.innerText || pseudo.before || pseudo.after || "";
-    const nodeHashId = midsceneGenerateHash(node, content, rect);
+    const nodeHashId = midsceneGenerateHash(node, content, rect2);
     const selector = setDataForNode(node, nodeHashId, false, currentWindow);
     const elementInfo = {
       id: nodeHashId,
@@ -653,12 +667,12 @@ function collectElementInfo(node, currentWindow, currentDocument, baseZoom = 1,
         nodeType: "BUTTON Node" /* BUTTON */
       },
       content,
-      rect,
+      rect: rect2,
       center: [
-        Math.round(rect.left + rect.width / 2),
-        Math.round(rect.top + rect.height / 2)
+        Math.round(rect2.left + rect2.width / 2),
+        Math.round(rect2.top + rect2.height / 2)
       ],
-      zoom: rect.zoom
+      zoom: rect2.zoom
     };
     return elementInfo;
   }
@@ -723,6 +737,33 @@ function collectElementInfo(node, currentWindow, currentDocument, baseZoom = 1,
     };
     return elementInfo;
   }
+  if (isAElement(node)) {
+    const attributes = getNodeAttributes(node, currentWindow);
+    const pseudo = getPseudoElementContent(node, currentWindow);
+    const content = node.innerText || pseudo.before || pseudo.after || "";
+    const nodeHashId = midsceneGenerateHash(node, content, rect);
+    const selector = setDataForNode(node, nodeHashId, false, currentWindow);
+    const elementInfo = {
+      id: nodeHashId,
+      indexId: indexId++,
+      nodeHashId,
+      nodeType: "Anchor Node" /* A */,
+      locator: selector,
+      attributes: {
+        ...attributes,
+        htmlTagName: tagNameOfNode(node),
+        nodeType: "Anchor Node" /* A */
+      },
+      content,
+      rect,
+      center: [
+        Math.round(rect.left + rect.width / 2),
+        Math.round(rect.top + rect.height / 2)
+      ],
+      zoom: rect.zoom
+    };
+    return elementInfo;
+  }
   if (isContainerElement(node)) {
     const attributes = getNodeAttributes(node, currentWindow);
     const nodeHashId = midsceneGenerateHash(node, "", rect);
@@ -797,7 +838,7 @@ function extractTreeNode(initNode, debugMode2 = false) {
       node: elementInfo,
       children: []
     };
-    if (elementInfo?.nodeType === "BUTTON Node" /* BUTTON */ || elementInfo?.nodeType === "IMG Node" /* IMG */ || elementInfo?.nodeType === "TEXT Node" /* TEXT */ || elementInfo?.nodeType === "FORM_ITEM Node" /* FORM_ITEM */ || elementInfo?.nodeType === "CONTAINER Node" /* CONTAINER */) {
+    if (elementInfo?.nodeType === "BUTTON Node" /* BUTTON */ || elementInfo?.nodeType === "IMG Node" /* IMG */ || elementInfo?.nodeType === "TEXT Node" /* TEXT */ || elementInfo?.nodeType === "Anchor Node" /* A */ || elementInfo?.nodeType === "FORM_ITEM Node" /* FORM_ITEM */ || elementInfo?.nodeType === "CONTAINER Node" /* CONTAINER */) {
       return nodeInfo;
     }
     const rect = getRect(node, baseZoom, currentWindow);
@@ -852,6 +893,50 @@ function extractTreeNode(initNode, debugMode2 = false) {
     children: topChildren
   };
 }
+function mergeElementAndChildrenRects(node, currentWindow, currentDocument, baseZoom = 1, visibleOnly = true) {
+  const selfRect = elementRect(
+    node,
+    currentWindow,
+    currentDocument,
+    baseZoom,
+    visibleOnly
+  );
+  if (!selfRect)
+    return null;
+  let minLeft = selfRect.left;
+  let minTop = selfRect.top;
+  let maxRight = selfRect.left + selfRect.width;
+  let maxBottom = selfRect.top + selfRect.height;
+  function traverse(child) {
+    for (let i = 0; i < child.childNodes.length; i++) {
+      const sub = child.childNodes[i];
+      if (sub.nodeType === 1) {
+        const rect = elementRect(
+          sub,
+          currentWindow,
+          currentDocument,
+          baseZoom,
+          visibleOnly
+        );
+        if (rect) {
+          minLeft = Math.min(minLeft, rect.left);
+          minTop = Math.min(minTop, rect.top);
+          maxRight = Math.max(maxRight, rect.left + rect.width);
+          maxBottom = Math.max(maxBottom, rect.top + rect.height);
+        }
+        traverse(sub);
+      }
+    }
+  }
+  traverse(node);
+  return {
+    ...selfRect,
+    left: minLeft,
+    top: minTop,
+    width: maxRight - minLeft,
+    height: maxBottom - minTop
+  };
+}
 
 // src/extractor/locator.ts
 var getElementIndex = (element) => {
@@ -865,16 +950,6 @@ var getElementIndex = (element) => {
   }
   return index;
 };
-var findFirstAncestorWithId = (element) => {
-  let current = element;
-  while (current?.parentElement) {
-    if (current.id) {
-      return current;
-    }
-    current = current.parentElement;
-  }
-  return null;
-};
 var getTextNodeIndex = (textNode) => {
   let index = 1;
   let current = textNode.previousSibling;
@@ -892,6 +967,10 @@ var getElementXPath = (element) => {
     if (parentNode && parentNode.nodeType === Node.ELEMENT_NODE) {
       const parentXPath = getElementXPath(parentNode);
       const textIndex = getTextNodeIndex(element);
+      const textContent = element.textContent?.trim();
+      if (textContent) {
+        return `${parentXPath}/text()[${textIndex}][normalize-space()="${textContent}"]`;
+      }
       return `${parentXPath}/text()[${textIndex}]`;
     }
     return "";
@@ -905,22 +984,6 @@ var getElementXPath = (element) => {
   if (el === document.body) {
     return "/html/body";
   }
-  if (el.id) {
-    return `//*[@id="${el.id}"]`;
-  }
-  const ancestorWithId = findFirstAncestorWithId(el);
-  if (ancestorWithId) {
-    const ancestorPath = `//*[@id="${ancestorWithId.id}"]`;
-    let current = el;
-    const pathParts = [];
-    while (current && current !== ancestorWithId) {
-      const index2 = getElementIndex(current);
-      const tagName2 = current.nodeName.toLowerCase();
-      pathParts.unshift(`${tagName2}[${index2}]`);
-      current = current.parentElement;
-    }
-    return pathParts.length > 0 ? `${ancestorPath}/${pathParts.join("/")}` : ancestorPath;
-  }
   if (!el.parentNode) {
     return `/${el.nodeName.toLowerCase()}`;
   }
@@ -935,8 +998,8 @@ var getElementXPath = (element) => {
 function generateXPaths(node) {
   if (!node)
     return [];
-  const xPath = getElementXPath(node);
-  return [xPath];
+  const fullXPath = getElementXPath(node);
+  return [fullXPath];
 }
 function getXpathsById(id) {
   const node = getNodeFromCacheList(id);

package/dist/lib/logger.js

@@ -171,7 +171,6 @@ var getMidsceneRunSubDir = (subdir) => {
   }
   return logPath;
 };
-var logDir = isNodeEnv ? getMidsceneRunSubDir("log") : "";
 
 // src/logger.ts
 var topicPrefix = "midscene";
@@ -179,7 +178,10 @@ var logStreams = /* @__PURE__ */ new Map();
 function getLogStream(topic) {
   const topicFileName = topic.replace(/:/g, "-");
   if (!logStreams.has(topicFileName)) {
-    const logFile = import_node_path2.default.join(logDir, `${topicFileName}.log`);
+    const logFile = import_node_path2.default.join(
+      getMidsceneRunSubDir("log"),
+      `${topicFileName}.log`
+    );
     const stream = import_node_fs2.default.createWriteStream(logFile, { flags: "a" });
     logStreams.set(topicFileName, stream);
   }

package/dist/script/htmlElement.js

@@ -755,6 +755,9 @@ ${indentStr}${after}`;
   function isButtonElement(node) {
     return node instanceof HTMLElement && node.tagName.toLowerCase() === "button";
   }
+  function isAElement(node) {
+    return node instanceof HTMLElement && node.tagName.toLowerCase() === "a";
+  }
   function isImgElement(node) {
     if (!includeBaseElement(node) && node instanceof Element) {
       const computedStyle = window.getComputedStyle(node);
@@ -805,7 +808,8 @@ ${indentStr}${after}`;
       "textarea",
       "select",
       "option",
-      "img"
+      "img",
+      "a"
     ];
     for (const tagName of includeList) {
       const element = node.querySelectorAll(tagName);
@@ -1196,10 +1200,20 @@ ${indentStr}${after}`;
       return elementInfo;
     }
     if (isButtonElement(node)) {
+      const rect2 = mergeElementAndChildrenRects(
+        node,
+        currentWindow,
+        currentDocument,
+        baseZoom,
+        visibleOnly
+      );
+      if (!rect2) {
+        return null;
+      }
       const attributes = getNodeAttributes(node, currentWindow);
       const pseudo = getPseudoElementContent(node, currentWindow);
       const content = node.innerText || pseudo.before || pseudo.after || "";
-      const nodeHashId = midsceneGenerateHash(node, content, rect);
+      const nodeHashId = midsceneGenerateHash(node, content, rect2);
       const selector = setDataForNode(node, nodeHashId, false, currentWindow);
       const elementInfo = {
         id: nodeHashId,
@@ -1212,12 +1226,12 @@ ${indentStr}${after}`;
           nodeType: "BUTTON Node" /* BUTTON */
         }),
         content,
-        rect,
+        rect: rect2,
         center: [
-          Math.round(rect.left + rect.width / 2),
-          Math.round(rect.top + rect.height / 2)
+          Math.round(rect2.left + rect2.width / 2),
+          Math.round(rect2.top + rect2.height / 2)
         ],
-        zoom: rect.zoom
+        zoom: rect2.zoom
       };
       return elementInfo;
     }
@@ -1279,6 +1293,32 @@ ${indentStr}${after}`;
       };
       return elementInfo;
     }
+    if (isAElement(node)) {
+      const attributes = getNodeAttributes(node, currentWindow);
+      const pseudo = getPseudoElementContent(node, currentWindow);
+      const content = node.innerText || pseudo.before || pseudo.after || "";
+      const nodeHashId = midsceneGenerateHash(node, content, rect);
+      const selector = setDataForNode(node, nodeHashId, false, currentWindow);
+      const elementInfo = {
+        id: nodeHashId,
+        indexId: indexId++,
+        nodeHashId,
+        nodeType: "Anchor Node" /* A */,
+        locator: selector,
+        attributes: __spreadProps(__spreadValues({}, attributes), {
+          htmlTagName: tagNameOfNode(node),
+          nodeType: "Anchor Node" /* A */
+        }),
+        content,
+        rect,
+        center: [
+          Math.round(rect.left + rect.width / 2),
+          Math.round(rect.top + rect.height / 2)
+        ],
+        zoom: rect.zoom
+      };
+      return elementInfo;
+    }
     if (isContainerElement(node)) {
       const attributes = getNodeAttributes(node, currentWindow);
       const nodeHashId = midsceneGenerateHash(node, "", rect);
@@ -1352,7 +1392,7 @@ ${indentStr}${after}`;
         node: elementInfo,
         children: []
       };
-      if ((elementInfo == null ? void 0 : elementInfo.nodeType) === "BUTTON Node" /* BUTTON */ || (elementInfo == null ? void 0 : elementInfo.nodeType) === "IMG Node" /* IMG */ || (elementInfo == null ? void 0 : elementInfo.nodeType) === "TEXT Node" /* TEXT */ || (elementInfo == null ? void 0 : elementInfo.nodeType) === "FORM_ITEM Node" /* FORM_ITEM */ || (elementInfo == null ? void 0 : elementInfo.nodeType) === "CONTAINER Node" /* CONTAINER */) {
+      if ((elementInfo == null ? void 0 : elementInfo.nodeType) === "BUTTON Node" /* BUTTON */ || (elementInfo == null ? void 0 : elementInfo.nodeType) === "IMG Node" /* IMG */ || (elementInfo == null ? void 0 : elementInfo.nodeType) === "TEXT Node" /* TEXT */ || (elementInfo == null ? void 0 : elementInfo.nodeType) === "Anchor Node" /* A */ || (elementInfo == null ? void 0 : elementInfo.nodeType) === "FORM_ITEM Node" /* FORM_ITEM */ || (elementInfo == null ? void 0 : elementInfo.nodeType) === "CONTAINER Node" /* CONTAINER */) {
         return nodeInfo;
       }
       const rect = getRect(node, baseZoom, currentWindow);
@@ -1407,6 +1447,49 @@ ${indentStr}${after}`;
       children: topChildren
     };
   }
+  function mergeElementAndChildrenRects(node, currentWindow, currentDocument, baseZoom = 1, visibleOnly = true) {
+    const selfRect = elementRect(
+      node,
+      currentWindow,
+      currentDocument,
+      baseZoom,
+      visibleOnly
+    );
+    if (!selfRect)
+      return null;
+    let minLeft = selfRect.left;
+    let minTop = selfRect.top;
+    let maxRight = selfRect.left + selfRect.width;
+    let maxBottom = selfRect.top + selfRect.height;
+    function traverse(child) {
+      for (let i = 0; i < child.childNodes.length; i++) {
+        const sub = child.childNodes[i];
+        if (sub.nodeType === 1) {
+          const rect = elementRect(
+            sub,
+            currentWindow,
+            currentDocument,
+            baseZoom,
+            visibleOnly
+          );
+          if (rect) {
+            minLeft = Math.min(minLeft, rect.left);
+            minTop = Math.min(minTop, rect.top);
+            maxRight = Math.max(maxRight, rect.left + rect.width);
+            maxBottom = Math.max(maxBottom, rect.top + rect.height);
+          }
+          traverse(sub);
+        }
+      }
+    }
+    traverse(node);
+    return __spreadProps(__spreadValues({}, selfRect), {
+      left: minLeft,
+      top: minTop,
+      width: maxRight - minLeft,
+      height: maxBottom - minTop
+    });
+  }
 
   // src/extractor/locator.ts
   var getElementIndex = (element) => {
@@ -1420,16 +1503,6 @@ ${indentStr}${after}`;
     }
     return index;
   };
-  var findFirstAncestorWithId = (element) => {
-    let current = element;
-    while (current == null ? void 0 : current.parentElement) {
-      if (current.id) {
-        return current;
-      }
-      current = current.parentElement;
-    }
-    return null;
-  };
   var getTextNodeIndex = (textNode) => {
     let index = 1;
     let current = textNode.previousSibling;
@@ -1442,11 +1515,16 @@ ${indentStr}${after}`;
     return index;
   };
   var getElementXPath = (element) => {
+    var _a;
     if (element.nodeType === Node.TEXT_NODE) {
       const parentNode = element.parentNode;
       if (parentNode && parentNode.nodeType === Node.ELEMENT_NODE) {
         const parentXPath = getElementXPath(parentNode);
         const textIndex = getTextNodeIndex(element);
+        const textContent = (_a = element.textContent) == null ? void 0 : _a.trim();
+        if (textContent) {
+          return `${parentXPath}/text()[${textIndex}][normalize-space()="${textContent}"]`;
+        }
         return `${parentXPath}/text()[${textIndex}]`;
       }
       return "";
@@ -1460,22 +1538,6 @@ ${indentStr}${after}`;
     if (el === document.body) {
       return "/html/body";
     }
-    if (el.id) {
-      return `//*[@id="${el.id}"]`;
-    }
-    const ancestorWithId = findFirstAncestorWithId(el);
-    if (ancestorWithId) {
-      const ancestorPath = `//*[@id="${ancestorWithId.id}"]`;
-      let current = el;
-      const pathParts = [];
-      while (current && current !== ancestorWithId) {
-        const index2 = getElementIndex(current);
-        const tagName2 = current.nodeName.toLowerCase();
-        pathParts.unshift(`${tagName2}[${index2}]`);
-        current = current.parentElement;
-      }
-      return pathParts.length > 0 ? `${ancestorPath}/${pathParts.join("/")}` : ancestorPath;
-    }
     if (!el.parentNode) {
       return `/${el.nodeName.toLowerCase()}`;
     }
@@ -1490,8 +1552,8 @@ ${indentStr}${after}`;
   function generateXPaths(node) {
     if (!node)
       return [];
-    const xPath = getElementXPath(node);
-    return [xPath];
+    const fullXPath = getElementXPath(node);
+    return [fullXPath];
   }
   function getXpathsById(id) {
     const node = getNodeFromCacheList(id);

package/dist/script/htmlElementDebug.js

@@ -611,6 +611,9 @@ var midscene_element_inspector = (() => {
   function isButtonElement(node) {
     return node instanceof HTMLElement && node.tagName.toLowerCase() === "button";
   }
+  function isAElement(node) {
+    return node instanceof HTMLElement && node.tagName.toLowerCase() === "a";
+  }
   function isImgElement(node) {
     if (!includeBaseElement(node) && node instanceof Element) {
       const computedStyle = window.getComputedStyle(node);
@@ -661,7 +664,8 @@ var midscene_element_inspector = (() => {
       "textarea",
       "select",
       "option",
-      "img"
+      "img",
+      "a"
     ];
     for (const tagName of includeList) {
       const element = node.querySelectorAll(tagName);
@@ -1045,10 +1049,20 @@ var midscene_element_inspector = (() => {
       return elementInfo;
     }
     if (isButtonElement(node)) {
+      const rect2 = mergeElementAndChildrenRects(
+        node,
+        currentWindow,
+        currentDocument,
+        baseZoom,
+        visibleOnly
+      );
+      if (!rect2) {
+        return null;
+      }
       const attributes = getNodeAttributes(node, currentWindow);
       const pseudo = getPseudoElementContent(node, currentWindow);
       const content = node.innerText || pseudo.before || pseudo.after || "";
-      const nodeHashId = midsceneGenerateHash(node, content, rect);
+      const nodeHashId = midsceneGenerateHash(node, content, rect2);
       const selector = setDataForNode(node, nodeHashId, false, currentWindow);
       const elementInfo = {
         id: nodeHashId,
@@ -1061,12 +1075,12 @@ var midscene_element_inspector = (() => {
           nodeType: "BUTTON Node" /* BUTTON */
         }),
         content,
-        rect,
+        rect: rect2,
         center: [
-          Math.round(rect.left + rect.width / 2),
-          Math.round(rect.top + rect.height / 2)
+          Math.round(rect2.left + rect2.width / 2),
+          Math.round(rect2.top + rect2.height / 2)
         ],
-        zoom: rect.zoom
+        zoom: rect2.zoom
       };
       return elementInfo;
     }
@@ -1128,6 +1142,32 @@ var midscene_element_inspector = (() => {
       };
       return elementInfo;
     }
+    if (isAElement(node)) {
+      const attributes = getNodeAttributes(node, currentWindow);
+      const pseudo = getPseudoElementContent(node, currentWindow);
+      const content = node.innerText || pseudo.before || pseudo.after || "";
+      const nodeHashId = midsceneGenerateHash(node, content, rect);
+      const selector = setDataForNode(node, nodeHashId, false, currentWindow);
+      const elementInfo = {
+        id: nodeHashId,
+        indexId: indexId++,
+        nodeHashId,
+        nodeType: "Anchor Node" /* A */,
+        locator: selector,
+        attributes: __spreadProps(__spreadValues({}, attributes), {
+          htmlTagName: tagNameOfNode(node),
+          nodeType: "Anchor Node" /* A */
+        }),
+        content,
+        rect,
+        center: [
+          Math.round(rect.left + rect.width / 2),
+          Math.round(rect.top + rect.height / 2)
+        ],
+        zoom: rect.zoom
+      };
+      return elementInfo;
+    }
     if (isContainerElement(node)) {
       const attributes = getNodeAttributes(node, currentWindow);
       const nodeHashId = midsceneGenerateHash(node, "", rect);
@@ -1197,7 +1237,7 @@ var midscene_element_inspector = (() => {
         node: elementInfo,
         children: []
       };
-      if ((elementInfo == null ? void 0 : elementInfo.nodeType) === "BUTTON Node" /* BUTTON */ || (elementInfo == null ? void 0 : elementInfo.nodeType) === "IMG Node" /* IMG */ || (elementInfo == null ? void 0 : elementInfo.nodeType) === "TEXT Node" /* TEXT */ || (elementInfo == null ? void 0 : elementInfo.nodeType) === "FORM_ITEM Node" /* FORM_ITEM */ || (elementInfo == null ? void 0 : elementInfo.nodeType) === "CONTAINER Node" /* CONTAINER */) {
+      if ((elementInfo == null ? void 0 : elementInfo.nodeType) === "BUTTON Node" /* BUTTON */ || (elementInfo == null ? void 0 : elementInfo.nodeType) === "IMG Node" /* IMG */ || (elementInfo == null ? void 0 : elementInfo.nodeType) === "TEXT Node" /* TEXT */ || (elementInfo == null ? void 0 : elementInfo.nodeType) === "Anchor Node" /* A */ || (elementInfo == null ? void 0 : elementInfo.nodeType) === "FORM_ITEM Node" /* FORM_ITEM */ || (elementInfo == null ? void 0 : elementInfo.nodeType) === "CONTAINER Node" /* CONTAINER */) {
         return nodeInfo;
       }
       const rect = getRect(node, baseZoom, currentWindow);
@@ -1252,6 +1292,49 @@ var midscene_element_inspector = (() => {
       children: topChildren
     };
   }
+  function mergeElementAndChildrenRects(node, currentWindow, currentDocument, baseZoom = 1, visibleOnly = true) {
+    const selfRect = elementRect(
+      node,
+      currentWindow,
+      currentDocument,
+      baseZoom,
+      visibleOnly
+    );
+    if (!selfRect)
+      return null;
+    let minLeft = selfRect.left;
+    let minTop = selfRect.top;
+    let maxRight = selfRect.left + selfRect.width;
+    let maxBottom = selfRect.top + selfRect.height;
+    function traverse(child) {
+      for (let i = 0; i < child.childNodes.length; i++) {
+        const sub = child.childNodes[i];
+        if (sub.nodeType === 1) {
+          const rect = elementRect(
+            sub,
+            currentWindow,
+            currentDocument,
+            baseZoom,
+            visibleOnly
+          );
+          if (rect) {
+            minLeft = Math.min(minLeft, rect.left);
+            minTop = Math.min(minTop, rect.top);
+            maxRight = Math.max(maxRight, rect.left + rect.width);
+            maxBottom = Math.max(maxBottom, rect.top + rect.height);
+          }
+          traverse(sub);
+        }
+      }
+    }
+    traverse(node);
+    return __spreadProps(__spreadValues({}, selfRect), {
+      left: minLeft,
+      top: minTop,
+      width: maxRight - minLeft,
+      height: maxBottom - minTop
+    });
+  }
 
   // src/extractor/debug.ts
   console.log(extractTextWithPosition(document.body, true));

package/dist/types/common.d.ts

@@ -10,6 +10,5 @@ declare const getMidsceneRunBaseDir: () => string;
  * @returns The absolute path to the requested directory
  */
 declare const getMidsceneRunSubDir: (subdir: "dump" | "cache" | "report" | "tmp" | "log" | "output") => string;
-declare const logDir: string;
 
-export { defaultRunDirName, getMidsceneRunBaseDir, getMidsceneRunDir, getMidsceneRunSubDir, isNodeEnv, logDir };
+export { defaultRunDirName, getMidsceneRunBaseDir, getMidsceneRunDir, getMidsceneRunSubDir, isNodeEnv };

package/dist/types/constants.d.ts

@@ -6,6 +6,7 @@ declare enum NodeType {
     CONTAINER = "CONTAINER Node",
     FORM_ITEM = "FORM_ITEM Node",
     BUTTON = "BUTTON Node",
+    A = "Anchor Node",
     IMG = "IMG Node",
     TEXT = "TEXT Node",
     POSITION = "POSITION Node"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@midscene/shared",
-  "version": "0.17.2",
+  "version": "0.17.3-beta-20250526042111.0",
   "repository": "https://github.com/web-infra-dev/midscene",
   "homepage": "https://midscenejs.com/",
   "types": "./dist/types/index.d.ts",

package/src/common.ts

@@ -62,5 +62,3 @@ export const getMidsceneRunSubDir = (
 
   return logPath;
 };
-
-export const logDir = isNodeEnv ? getMidsceneRunSubDir('log') : '';

package/src/constants/index.ts

@@ -9,6 +9,7 @@ export enum NodeType {
   CONTAINER = 'CONTAINER Node',
   FORM_ITEM = 'FORM_ITEM Node',
   BUTTON = 'BUTTON Node',
+  A = 'Anchor Node',
   IMG = 'IMG Node',
   TEXT = 'TEXT Node',
   POSITION = 'POSITION Node',

package/src/extractor/dom-util.ts

@@ -17,6 +17,12 @@ export function isButtonElement(
   return node instanceof HTMLElement && node.tagName.toLowerCase() === 'button';
 }
 
+export function isAElement(
+  node: globalThis.Node,
+): node is globalThis.HTMLButtonElement {
+  return node instanceof HTMLElement && node.tagName.toLowerCase() === 'a';
+}
+
 export function isImgElement(
   node: globalThis.Node,
 ): node is globalThis.HTMLImageElement {
@@ -90,6 +96,7 @@ function includeBaseElement(node: globalThis.Node) {
     'select',
     'option',
     'img',
+    'a',
   ];
 
   for (const tagName of includeList) {