ff-automationv2 2.2.0 → 2.2.5

package/src/utils/helpers/xpathcreation.ts

@@ -1,59 +0,0 @@
-import { DOMParser } from "@xmldom/xmldom";
-import xpath from "xpath";
-// import { logger } from "../logger/logData.js";
-
-export function getFFIndexAndXPath(
-  annotatedDom: string,
-  fireflinkIndex: string
-): string  {
-
-  try{
-
- const parser = new DOMParser();
-  const xmlDoc = parser.parseFromString(annotatedDom, "text/xml");
-
-  const xpathQuery = `//*[@FF-inspecter='${fireflinkIndex}']`;
-
-  const nodes = xpath.select(xpathQuery, xmlDoc) as Node[];
-
-  const element = nodes.length ? (nodes[0] as Element) : null;
-
-  function buildXPath(node: Node): string {
-    if (node.nodeType !== 1) return "";
-
-    const parts: string[] = [];
-
-    while (node && node.nodeType === 1) {
-
-      let index = 1;
-      let sibling = node.previousSibling;
-
-      while (sibling) {
-        if (
-          sibling.nodeType === 1 &&
-          (sibling as Element).tagName === (node as Element).tagName
-        ) {
-          index++;
-        }
-        sibling = sibling.previousSibling;
-      }
-
-      parts.unshift(`${(node as Element).tagName}[${index}]`);
-      node = node.parentNode!;
-    }
-
-    return "/" + parts.join("/");
-  }
-
-  let xpathPath = "";
-
-  if (element) {
-    xpathPath = buildXPath(element);
-  }
-
-  return xpathPath;
-} 
-  catch(error:any){
-    throw new Error( "Error in getFFIndexAndXPath",{cause : error} );
-  }
-}

package/src/utils/iframesExtraction/findElementUsingFF.ts

@@ -1,45 +0,0 @@
-import { IFindElementUsingFF } from "./iframeInterface.js";
-import { switchToIframeByMeta } from "./switchToIframeByMeta.js";
-
-export const findElementUsingFF: (args: IFindElementUsingFF) => Promise<void> =
-    async (args) => {
-
-        await args.driver.switchToFrame(null);
-
-        const usedElementNames: string[] = [];
-
-        for (const frameMeta of args.frames) {
-
-            const xpathUsed = await switchToIframeByMeta(args.driver, frameMeta);
-
-            if (xpathUsed) {
-
-                let finalElementName = args.elementName;
-
-                if (finalElementName) {
-                    const baseName = finalElementName;
-                    let newName = baseName;
-                    let count = 0;
-
-                    while (usedElementNames.includes(newName)) {
-                        count++;
-                        newName = `${baseName}_${count}`;
-                    }
-
-                    finalElementName = newName;
-                    usedElementNames.push(finalElementName);
-                }
-
-                args.scriptDataAppender.add(async () => ({
-                    nlpName: 'SwitchToFrameByFrameElement',
-                    stepInputs: [],
-                    elementsData: [{
-                        name: finalElementName,
-                        type: args.elementType,
-                        locators: [{ name: "xpath", value: xpathUsed }],
-                        platform: args.platform
-                    }]
-                }));
-            }
-        }
-    };

package/src/utils/iframesExtraction/iframeInterface.ts

@@ -1,22 +0,0 @@
-
-import { ScriptDataAppender } from "../../fireflinkData/fireflinkScript/scriptGenrationData";
-
-export interface FrameMeta {
-    id?: string;
-    name?: string;
-    title?: string;
-    aria?: string;
-    src?: string;
-}
-
-export interface IFindElementUsingFF {
-
-    driver: WebdriverIO.Browser,
-    selector: string,
-    frames: FrameMeta[],
-    scriptDataAppender: ScriptDataAppender,
-    elementName: string,
-    elementType: string,
-    platform: string
-
-}

package/src/utils/iframesExtraction/switchToIframeByMeta.ts

@@ -1,23 +0,0 @@
-import { FrameMeta } from "./iframeInterface.js";
-
-export async function switchToIframeByMeta(driver: WebdriverIO.Browser, frameMeta: FrameMeta): Promise<string | null> {
-    const selectors = [
-        frameMeta.id && `//*[@id='${frameMeta.id}']`,
-        frameMeta.name && `//*[@name='${frameMeta.name}']`,
-        frameMeta.title && `//iframe[@title='${frameMeta.title}']`,
-        frameMeta.aria && `//iframe[@aria-label='${frameMeta.aria}']`,
-        frameMeta.src && `//iframe[contains(@src,'${frameMeta.src}')]`,
-    ].filter(Boolean) as string[];
-
-    for (const selector of selectors) {
-        try {
-            const iframe = await driver.$(selector);
-            if (await iframe.isExisting()) {
-                await driver.switchToFrame(iframe);
-                return selector;
-            }
-        } catch { continue; }
-    }
-
-    return null;
-}

package/src/utils/javascript/jsFindElement.ts

@@ -1,169 +0,0 @@
-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/src/utils/javascript/jsForShadowRoot.ts

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

package/src/utils/javascript/jsForToaster.ts

@@ -1,60 +0,0 @@
-export const TOAST_WATCHER_JS = `
-(function () {
-
-  // --- STOP any old watcher first ---
-  if (window.__toastObserver) {
-    try { window.__toastObserver.disconnect(); } catch(e) {}
-  }
-
-  // --- Reset state for this step ---
-  window.__toastDetected = false;
-  window.__lastToastText = null;
-
-  function isVisible(el) {
-    const r = el.getBoundingClientRect();
-    const s = getComputedStyle(el);
-    return r.width > 0 && r.height > 0 &&
-           s.display !== "none" &&
-           s.visibility !== "hidden" &&
-           s.opacity !== "0";
-  }
-
-  const observer = new MutationObserver(muts => {
-    for (const m of muts) {
-
-      // New elements
-      for (const node of m.addedNodes || []) {
-        if (node.nodeType !== 1) continue;
-        const text = node.innerText?.trim();
-        if (!text || text.length < 3 || text.length > 300) continue;
-        if (!isVisible(node)) continue;
-
-        window.__toastDetected = true;
-        window.__lastToastText = text;
-        return;
-      }
-
-      // Text changes
-      if (m.type === "characterData") {
-        const el = m.target.parentElement;
-        if (!el) continue;
-        const text = el.innerText?.trim();
-        if (!text || text.length < 3 || text.length > 300) continue;
-        if (!isVisible(el)) continue;
-
-        window.__toastDetected = true;
-        window.__lastToastText = text;
-        return;
-      }
-    }
-  });
-
-  observer.observe(document.body, {
-    childList: true,
-    subtree: true,
-    characterData: true
-  });
-
-  window.__toastObserver = observer;
-})();
-`;