ff-automationv2 2.1.3 → 2.2.2

package/{src/utils/javascript/jsFindElement.ts → dist/utils/javascript/jsFindElement.js}

@@ -1,161 +1,169 @@
-export const Find_element_by_ff_js_script = `
-  const target = arguments[0];
-  const callback = arguments[arguments.length - 1];
-
-  const MAX_WAIT = 2000;
-  const INTERVAL = 50;
-  const start = Date.now();
-
-  // ---------------- FINDER ----------------
-  function findByFfInspect(root) {
-      const visited = new Set();
-      const stack = [{ node: root, frames: [] }];
-
-      while (stack.length > 0) {
-          const { node, frames } = stack.pop();
-          if (!node) continue;
-
-          if (
-              node.nodeType === Node.DOCUMENT_NODE ||
-              node.nodeType === Node.DOCUMENT_FRAGMENT_NODE
-          ) {
-              if (visited.has(node)) continue;
-              visited.add(node);
-          }
-
-          if (node.nodeType === Node.ELEMENT_NODE) {
-
-              if (node.getAttribute && node.getAttribute("ff-inspect") === target) {
-                  return { node, frames };
-              }
-
-              if (node.shadowRoot) {
-                  stack.push({ node: node.shadowRoot, frames });
-              }
-
-              if (node.tagName === "IFRAME") {
-                try {
-                    const doc = node.contentDocument || node.contentWindow?.document;
-                    if (doc) {
-                        const meta = {
-                            id: node.id || null,
-                            name: node.getAttribute("name") || null,
-                            title: node.getAttribute("title") || null,
-                            aria: node.getAttribute("aria-label") || null,
-                            src: node.getAttribute("src") || null,
-                        };
-
-                        stack.push({
-                            node: doc,
-                            frames: [...frames, meta]
-                        });
-                    }
-                } catch (e) {}
-              }
-
-              const kids = node.children || node.childNodes;
-              for (let i = kids.length - 1; i >= 0; i--) {
-                  stack.push({ node: kids[i], frames });
-              }
-          }
-
-          else if (
-              node.nodeType === Node.DOCUMENT_NODE ||
-              node.nodeType === Node.DOCUMENT_FRAGMENT_NODE
-          ) {
-              const kids = node.childNodes;
-              for (let i = kids.length - 1; i >= 0; i--) {
-                  stack.push({ node: kids[i], frames });
-              }
-          }
-      }
-
-      return null;
-  }
-
-  // ---------------- CLICKABILITY ----------------
-  function isClickable(el) {
-      if (!el || el.nodeType !== Node.ELEMENT_NODE) return false;
-      const tag = el.tagName.toLowerCase();
-      if (tag === "button" || tag === "a") return true;
-      if (el.getAttribute("role") === "button") return true;
-      if (tag === "input") {
-          const t = (el.getAttribute("type") || "").toLowerCase();
-          return t === "button" || t === "submit";
-      }
-      return false;
-  }
-
-  function findClickableInside(root) {
-      const queue = [root];
-      while (queue.length) {
-          const node = queue.shift();
-          if (isClickable(node)) return node;
-          const kids = node.children || node.childNodes;
-          for (let k of kids) queue.push(k);
-      }
-      return null;
-  }
-
-  // ---------------- XPATH BUILDER ----------------
-  function buildXPath(el) {
-      if (!el) return null;
-
-      if (el.id) return \`//*[@id="\${el.id}"]\`;
-
-      const name = el.getAttribute("name");
-      if (name) return \`//*[@name="\${name}"]\`;
-
-      const text = el.textContent && el.textContent.trim();
-      if (text && text.length < 50) {
-          const escaped = text.replace(/"/g, '\\\\"');
-          const xp = \`//*[text()="\${escaped}"]\`;
-          try {
-              const n = document.evaluate(xp, document, null, XPathResult.FIRST_ORDERED_NODE_TYPE, null);
-              if (n.singleNodeValue === el) return xp;
-          } catch {}
-      }
-
-      const parts = [];
-      let node = el;
-
-      while (node && node.nodeType === Node.ELEMENT_NODE) {
-          let idx = 1;
-          let sib = node.previousSibling;
-          while (sib) {
-              if (sib.nodeType === Node.ELEMENT_NODE && sib.nodeName === node.nodeName) idx++;
-              sib = sib.previousSibling;
-          }
-          parts.unshift(node.nodeName.toLowerCase() + "[" + idx + "]");
-          node = node.parentNode instanceof ShadowRoot ? node.parentNode.host : node.parentNode;
-      }
-
-      return "/" + parts.join("/");
-  }
-
-  // ---------------- WAIT LOOP ----------------
-  (function attempt() {
-      const found = findByFfInspect(document);
-
-      if (!found) {
-          if (Date.now() - start > MAX_WAIT) {
-              return callback({ success: false, reason: "timeout" });
-          }
-          return setTimeout(attempt, INTERVAL);
-      }
-
-      let targetNode = found.node;
-      if (!isClickable(targetNode)) {
-          const inside = findClickableInside(targetNode);
-          if (inside) targetNode = inside;
-      }
-
-      const xpath = buildXPath(targetNode);
-
-      return callback({
-          success: true,
-          xpath,
-          frames: found.frames
-      });
-  })();
+export const Find_element_by_ff_js_script = `
+  const target = arguments[0];
+  const callback = arguments[arguments.length - 1];
+
+  const MAX_WAIT = 2000;
+  const INTERVAL = 50;
+  const start = Date.now();
+
+  // ---------------- FINDER ----------------
+  function findByFfInspect(root) {
+      const visited = new Set();
+      const stack = [{ node: root, frames: [], currentDoc: root }];
+
+      while (stack.length > 0) {
+          const { node, frames, currentDoc } = stack.pop();
+          if (!node) continue;
+
+          if (
+              node.nodeType === Node.DOCUMENT_NODE ||
+              node.nodeType === Node.DOCUMENT_FRAGMENT_NODE
+          ) {
+              if (visited.has(node)) continue;
+              visited.add(node);
+          }
+
+          if (node.nodeType === Node.ELEMENT_NODE) {
+
+              if (node.getAttribute && node.getAttribute("ff-inspect") === target) {
+                  return { node, frames, iframe_dom: currentDoc };
+              }
+
+              // Shadow DOM
+              if (node.shadowRoot) {
+                  stack.push({
+                      node: node.shadowRoot,
+                      frames,
+                      currentDoc
+                  });
+              }
+
+              // Iframe traversal
+              if (node.tagName === "IFRAME") {
+                  try {
+                      const doc = node.contentDocument || node.contentWindow?.document;
+                      if (doc) {
+                          const meta = {
+                              id: node.id || null,
+                              name: node.getAttribute("name") || null,
+                              title: node.getAttribute("title") || null,
+                              aria: node.getAttribute("aria-label") || null,
+                              src: node.getAttribute("src") || null,
+                          };
+
+                          stack.push({
+                              node: doc,
+                              frames: [...frames, meta],
+                              currentDoc: doc
+                          });
+                      }
+                  } catch (e) {}
+              }
+
+              const kids = node.children || node.childNodes;
+              for (let i = kids.length - 1; i >= 0; i--) {
+                  stack.push({ node: kids[i], frames, currentDoc });
+              }
+          }
+
+          else if (
+              node.nodeType === Node.DOCUMENT_NODE ||
+              node.nodeType === Node.DOCUMENT_FRAGMENT_NODE
+          ) {
+              const kids = node.childNodes;
+              for (let i = kids.length - 1; i >= 0; i--) {
+                  stack.push({ node: kids[i], frames, currentDoc });
+              }
+          }
+      }
+
+      return null;
+  }
+
+  // ---------------- CLICKABILITY ----------------
+  function isClickable(el) {
+      if (!el || el.nodeType !== Node.ELEMENT_NODE) return false;
+      const tag = el.tagName.toLowerCase();
+      if (tag === "button" || tag === "a") return true;
+      if (el.getAttribute("role") === "button") return true;
+      if (tag === "input") {
+          const t = (el.getAttribute("type") || "").toLowerCase();
+          return t === "button" || t === "submit";
+      }
+      return false;
+  }
+
+  function findClickableInside(root) {
+      const queue = [root];
+      while (queue.length) {
+          const node = queue.shift();
+          if (isClickable(node)) return node;
+          const kids = node.children || node.childNodes;
+          for (let k of kids) queue.push(k);
+      }
+      return null;
+  }
+
+  // ---------------- XPATH BUILDER ----------------
+  function buildXPath(el) {
+      if (!el) return null;
+
+      if (el.id) return "//*[@id=\\"" + el.id + "\\"]";
+
+      const name = el.getAttribute("name");
+      if (name) return "//*[@name=\\"" + name + "\\"]";
+
+      const text = el.textContent && el.textContent.trim();
+      if (text && text.length < 50) {
+          const escaped = text.replace(/"/g, '\\"');
+          const xp = "//*[text()=\\"" + escaped + "\\"]";
+          try {
+              const n = document.evaluate(xp, document, null, XPathResult.FIRST_ORDERED_NODE_TYPE, null);
+              if (n.singleNodeValue === el) return xp;
+          } catch {}
+      }
+
+      const parts = [];
+      let node = el;
+
+      while (node && node.nodeType === Node.ELEMENT_NODE) {
+          let idx = 1;
+          let sib = node.previousSibling;
+          while (sib) {
+              if (sib.nodeType === Node.ELEMENT_NODE && sib.nodeName === node.nodeName) idx++;
+              sib = sib.previousSibling;
+          }
+          parts.unshift(node.nodeName.toLowerCase() + "[" + idx + "]");
+          node = node.parentNode instanceof ShadowRoot ? node.parentNode.host : node.parentNode;
+      }
+
+      return "/" + parts.join("/");
+  }
+
+  // ---------------- WAIT LOOP ----------------
+  (function attempt() {
+      const found = findByFfInspect(document);
+
+      if (!found) {
+          if (Date.now() - start > MAX_WAIT) {
+              return callback({ success: false, reason: "timeout" });
+          }
+          return setTimeout(attempt, INTERVAL);
+      }
+
+      let targetNode = found.node;
+      if (!isClickable(targetNode)) {
+          const inside = findClickableInside(targetNode);
+          if (inside) targetNode = inside;
+      }
+
+      const xpath_if = buildXPath(targetNode);
+
+      return callback({
+          success: true,
+          xpath_if,
+          frames: found.frames,
+          iframe_dom_html: found.iframe_dom?.documentElement?.outerHTML || null
+      });
+  })();
 `;

package/dist/utils/javascript/jsForShadowRoot.d.ts

@@ -0,0 +1,6 @@
+export declare const SHADOW_DOM_CLICK_JS = "\nconst path = arguments[0];\n\nfunction resolve(path) {\n\n  function toCss(sel) {\n    return sel.replace(/(\\w+)\\[(\\d+)\\]/g,\n      (_, t, n) => `${t}:nth-of-type(${n})`);\n  }\n\n  const parts = path.split(\"/shadow/\");\n  let node = document.evaluate(\n    parts[0],\n    document,\n    null,\n    XPathResult.FIRST_ORDERED_NODE_TYPE,\n    null\n  ).singleNodeValue;\n\n  for (let i = 1; i < parts.length; i++) {\n    node = node.shadowRoot.querySelector(\n      toCss(parts[i].replace(/\\//g, \" > \"))\n    );\n  }\n\n  return node;\n}\n\nconst targetNode = resolve(path);\nif (targetNode) {\n  targetNode.click();\n  return true;\n}\nreturn false;\n";
+export declare const SHADOW_DOM_ENTER_JS = "\nconst path = arguments[0];\nconst value = arguments[1];\n\nfunction resolve(path) {\n\n  function toCss(sel) {\n    return sel.replace(/(\\w+)\\[(\\d+)\\]/g,\n      (_, t, n) => `${t}:nth-of-type(${n})`);\n  }\n\n  const parts = path.split(\"/shadow/\");\n  let node = document.evaluate(\n    parts[0],\n    document,\n    null,\n    XPathResult.FIRST_ORDERED_NODE_TYPE,\n    null\n  ).singleNodeValue;\n\n  for (let i = 1; i < parts.length; i++) {\n    node = node.shadowRoot.querySelector(\n      toCss(parts[i].replace(/\\//g, \" > \"))\n    );\n  }\n\n  return node;\n}\n\nconst el = resolve(path);\nif (el) {\n  el.focus();\n  el.value = \"\";\n  el.value = value;\n  el.dispatchEvent(new Event(\"input\", { bubbles: true }));\n  el.dispatchEvent(new Event(\"change\", { bubbles: true }));\n  return true;\n}\nreturn false;\n";
+export declare const SHADOW_DOM_UPLOAD_JS = "\nconst path = arguments[0];\n\nfunction resolve(path) {\n\n  function toCss(sel) {\n    return sel.replace(/(\\w+)\\[(\\d+)\\]/g,\n      (_, t, n) => `${t}:nth-of-type(${n})`);\n  }\n\n  const parts = path.split(\"/shadow/\");\n  let node = document.evaluate(\n    parts[0],\n    document,\n    null,\n    XPathResult.FIRST_ORDERED_NODE_TYPE,\n    null\n  ).singleNodeValue;\n\n  for (let i = 1; i < parts.length; i++) {\n    node = node.shadowRoot.querySelector(\n      toCss(parts[i].replace(/\\//g, \" > \"))\n    );\n  }\n\n  return node;\n}\n\nreturn resolve(path);\n";
+export declare const SHADOW_DOM_GET_TEXT_JS = "\nconst path = arguments[0];\n\nfunction resolve(path) {\n\n  function toCss(sel) {\n    return sel.replace(/(\\w+)\\[(\\d+)\\]/g,\n      (_, t, n) => `${t}:nth-of-type(${n})`);\n  }\n\n  const parts = path.split(\"/shadow/\");\n\n  let node = document.evaluate(\n    parts[0],\n    document,\n    null,\n    XPathResult.FIRST_ORDERED_NODE_TYPE,\n    null\n  ).singleNodeValue;\n\n  for (let i = 1; i < parts.length; i++) {\n    if (!node || !node.shadowRoot) return null;\n    node = node.shadowRoot.querySelector(\n      toCss(parts[i].replace(/\\//g, \" > \"))\n    );\n  }\n\n  return node;\n}\n\nconst el = resolve(path);\nreturn el ? el.innerText.trim() : null;\n";
+export declare const SHADOW_DOM_VERIFY_TEXT_JS = "\nconst path = arguments[0];\nconst text = arguments[1];\n\nfunction resolve(path) {\n\n  function toCss(sel) {\n    return sel.replace(/(\\w+)\\[(\\d+)\\]/g,\n      (_, t, n) => `${t}:nth-of-type(${n})`);\n  }\n\n  const parts = path.split(\"/shadow/\");\n\n  let node = document.evaluate(\n    parts[0],\n    document,\n    null,\n    XPathResult.FIRST_ORDERED_NODE_TYPE,\n    null\n  ).singleNodeValue;\n\n  for (let i = 1; i < parts.length; i++) {\n    if (!node || !node.shadowRoot) return null;\n    node = node.shadowRoot.querySelector(\n      toCss(parts[i].replace(/\\//g, \" > \"))\n    );\n  }\n\n  return node;\n}\n\nconst el = resolve(path);\nreturn el ? el.innerText.trim() === text : false;\n";
+export declare const SHADOW_DOM_VERIFY_PARTIAL_TEXT_JS = "\nconst path = arguments[0];\nconst expected = arguments[1];\n\nfunction resolve(path) {\n\n  function toCss(sel) {\n    return sel.replace(/(\\w+)\\[(\\d+)\\]/g,\n      (_, t, n) => `${t}:nth-of-type(${n})`);\n  }\n\n  const parts = path.split(\"/shadow/\");\n\n  let node = document.evaluate(\n    parts[0],\n    document,\n    null,\n    XPathResult.FIRST_ORDERED_NODE_TYPE,\n    null\n  ).singleNodeValue;\n\n  for (let i = 1; i < parts.length; i++) {\n    if (!node || !node.shadowRoot) return null;\n    node = node.shadowRoot.querySelector(\n      toCss(parts[i].replace(/\\//g, \" > \"))\n    );\n  }\n\n  return node;\n}\n\nconst el = resolve(path);\nif (!el) return false;\n\nconst text = el.innerText ? el.innerText.trim() : \"\";\nreturn text.includes(expected);\n";