ff-automationv2 2.2.29 → 2.2.30

package/dist/utils/browserCap/capability.js

@@ -1,39 +1,115 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getCapabilities = getCapabilities;
-function getCapabilities(browserName, path, profile) {
+function getCapabilities(browserName, path, profile, customCaps = []) {
     const isLinux = process.platform === 'linux';
+    const caps = customCaps.map(c => c.toLowerCase());
+    const hasCap = (name) => caps.includes(name.toLowerCase());
+    const getChromiumArgs = (isEdge) => {
+        const args = [
+            ...(path ? [`--user-data-dir=${path}`] : []),
+            ...(profile ? [`--profile-directory=${profile}`] : []),
+            ...(isLinux ? ['--ozone-platform=x11'] : []),
+        ];
+        if (hasCap("headless"))
+            args.push('--headless=new');
+        if (hasCap("incognito"))
+            args.push(isEdge ? '--inprivate' : '--incognito');
+        if (hasCap("ignoreCertificates"))
+            args.push('--ignore-certificate-errors');
+        if (hasCap("startMaximized"))
+            args.push('--start-maximized');
+        if (hasCap("disableGpu"))
+            args.push('--disable-gpu');
+        if (hasCap("disableNotifications"))
+            args.push('--disable-notifications');
+        if (hasCap("disableExtensions"))
+            args.push('--disable-extensions');
+        if (hasCap("disablePopups"))
+            args.push('--disable-popup-blocking');
+        if (hasCap("muteAudio"))
+            args.push('--mute-audio');
+        if (hasCap("noSandbox"))
+            args.push('--no-sandbox', '--disable-dev-shm-usage');
+        if (hasCap("disableWebSecurity"))
+            args.push('--disable-web-security');
+        if (hasCap("disableLocalNetwork"))
+            args.push('--disable-local-network-saving-common-name');
+        return args;
+    };
+    const getChromiumPrefs = () => {
+        const prefs = {};
+        if (hasCap("geolocation"))
+            prefs["profile.default_content_setting_values.geolocation"] = 2;
+        if (hasCap("camera"))
+            prefs["profile.default_content_setting_values.media_stream_camera"] = 2;
+        if (hasCap("microphone"))
+            prefs["profile.default_content_setting_values.media_stream_mic"] = 2;
+        if (hasCap("popups") || hasCap("disablePopups"))
+            prefs["profile.default_content_settings.popups"] = 0;
+        if (hasCap("passwordManager")) {
+            prefs["credentials_enable_service"] = false;
+            prefs["profile.password_manager_enabled"] = false;
+        }
+        return prefs;
+    };
+    const getFirefoxOptions = () => {
+        const args = [
+            ...(path ? ['-profile', path] : []),
+            ...(isLinux ? ['--ozone-platform=x11'] : []),
+        ];
+        if (hasCap("headless"))
+            args.push('-headless');
+        if (hasCap("incognito"))
+            args.push('-private');
+        if (hasCap("disableGpu"))
+            args.push('--disable-gpu');
+        if (hasCap("disableExtensions"))
+            args.push('-safe-mode');
+        const prefs = {};
+        if (hasCap("disableNotifications") || hasCap("notifications"))
+            prefs["dom.webnotifications.enabled"] = false;
+        if (hasCap("disablePopups") || hasCap("popups"))
+            prefs["dom.disable_open_during_load"] = false;
+        if (hasCap("muteAudio"))
+            prefs["media.volume_scale"] = "0.0";
+        if (hasCap("disableWebSecurity"))
+            prefs["security.fileuri.strict_origin_policy"] = false;
+        if (hasCap("geolocation"))
+            prefs["geo.enabled"] = false;
+        if (hasCap("camera"))
+            prefs["media.navigator.permission.disabled"] = true;
+        if (hasCap("microphone"))
+            prefs["media.peerconnection.enabled"] = false;
+        if (hasCap("passwordManager"))
+            prefs["signon.rememberSignons"] = false;
+        return { args, prefs };
+    };
+    const firefoxOptions = getFirefoxOptions();
     const browserCapabilities = {
         chrome: {
             browserName: 'chrome',
             "wdio:enforceWebDriverClassic": true,
             "goog:chromeOptions": {
-                args: [
-                    ...(path ? [`--user-data-dir=${path}`] : []),
-                    ...(profile ? [`--profile-directory=${profile}`] : []),
-                    ...(isLinux ? ['--ozone-platform=x11'] : []),
-                ],
+                args: getChromiumArgs(false),
+                prefs: getChromiumPrefs()
             },
         },
         firefox: {
             browserName: 'firefox',
             "wdio:enforceWebDriverClassic": true,
+            acceptInsecureCerts: hasCap("ignoreCertificates"),
             "moz:firefoxOptions": {
-                args: [
-                    ...(path ? ['-profile', path] : []),
-                    ...(isLinux ? ['--ozone-platform=x11'] : []),
-                ],
+                args: firefoxOptions.args,
+                prefs: firefoxOptions.prefs
             },
         },
         edge: {
             browserName: 'MicrosoftEdge',
             "wdio:enforceWebDriverClassic": true,
             "ms:edgeOptions": {
-                args: [
-                    ...(path ? [`--user-data-dir=${path}`] : []),
-                    ...(profile ? [`--profile-directory=${profile}`] : []),
-                    ...(isLinux ? ['--ozone-platform=x11'] : []),
-                ],
+                args: getChromiumArgs(true),
+                prefs: getChromiumPrefs()
             },
         },
         safari: {

package/dist/utils/helpers/domSanitizer.d.ts

@@ -0,0 +1 @@
+export declare const sanitizeWebDom: (domString: string) => string;

package/dist/utils/helpers/domSanitizer.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sanitizeWebDom = void 0;
+const sanitizeWebDom = (domString) => {
+    return (domString || "")
+        .replace(/<noscript[\s\S]*?<\/noscript>/gi, "")
+        .replace(/<noscript[^>]*>/gi, "");
+};
+exports.sanitizeWebDom = sanitizeWebDom;

package/dist/utils/helpers/enterActionHelper.js

@@ -8,13 +8,14 @@ exports.enterActionHelperMob = enterActionHelperMob;
 const jsdom_1 = require("jsdom");
 const xmldom_1 = require("@xmldom/xmldom");
 const xpathcreation_js_1 = require("./xpathcreation.js");
+const domSanitizer_js_1 = require("./domSanitizer.js");
 const logData_js_1 = require("../logger/logData.js");
 const xpath_1 = __importDefault(require("xpath"));
 const enterActionHelper = (pageDOM, ffNumber) => {
     //  Extract numeric part
     const match = ffNumber.match(/\d+$/);
     let numericFF = match ? parseInt(match[0], 10) : 0;
-    const parser = new jsdom_1.JSDOM(pageDOM);
+    const parser = new jsdom_1.JSDOM((0, domSanitizer_js_1.sanitizeWebDom)(pageDOM));
     const doc = parser.window.document;
     const isEditable = (el) => {
         if (!el)
@@ -24,11 +25,21 @@ const enterActionHelper = (pageDOM, ffNumber) => {
             el.getAttribute("contenteditable") === "true");
     };
     const getXPath = (el) => {
-        return el?.getAttribute("ff-xpath") || "";
+        if (!el)
+            return "";
+        const directXpath = el.getAttribute("ff-xpath");
+        if (directXpath)
+            return directXpath;
+        const ffAttr = el.getAttribute("ff-inspect");
+        if (ffAttr) {
+            return (0, xpathcreation_js_1.getWebXPathByFFIndex)(pageDOM, ffAttr).xpathPath || "";
+        }
+        return "";
     };
     const element = doc.querySelector(`[ff-inspect="Fire-Flink-${numericFF}"]`);
     if (!element) {
-        return { ffNumber: numericFF, xpathPath: "" };
+        const fallbackResult = (0, xpathcreation_js_1.getWebXPathByFFIndex)(pageDOM, `Fire-Flink-${numericFF}`);
+        return { ffNumber: numericFF, xpathPath: fallbackResult.xpathPath || "" };
     }
     let xpathPath = "";
     //  Current element editable
@@ -46,6 +57,11 @@ const enterActionHelper = (pageDOM, ffNumber) => {
         }
         if (editableChild) {
             xpathPath = getXPath(editableChild);
+            const childFF = editableChild.getAttribute("ff-inspect");
+            const match = childFF?.match(/\d+$/);
+            if (match) {
+                numericFF = parseInt(match[0], 10);
+            }
         }
         else {
             // Try next 10 FF elements
@@ -64,7 +80,10 @@ const enterActionHelper = (pageDOM, ffNumber) => {
             }
         }
     }
-    // console.log("xpathPath", xpathPath);
+    if (!xpathPath) {
+        const fallbackResult = (0, xpathcreation_js_1.getWebXPathByFFIndex)(pageDOM, `Fire-Flink-${numericFF}`);
+        xpathPath = fallbackResult.xpathPath || "";
+    }
     return {
         ffNumber: numericFF,
         xpathPath

package/dist/utils/helpers/xpathcreation.js

@@ -64,7 +64,7 @@ function getFFIndexAndXPath(annotatedDom, fireflinkIndex, platform) {
             return { xpathPath: "" };
         }
         const ffInspector = element.getAttribute("FF-inspecter") || "";
-        function buildXPath(node) {
+        function buildAiXPath(node) {
             if (node.nodeType !== 1)
                 return "";
             const parts = [];
@@ -83,7 +83,7 @@ function getFFIndexAndXPath(annotatedDom, fireflinkIndex, platform) {
             }
             return "/" + parts.join("/");
         }
-        let xpathPath = buildXPath(element);
+        let xpathPath = buildAiXPath(element);
         xpathPath = xpathPath.replace("/AppiumAUT[1]", "");
         if (isBounds) {
             return {

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

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

package/dist/utils/javascript/jsFindElement.js

@@ -108,7 +108,7 @@ exports.Find_element_by_ff_js_script = `
   }
 
   // ---------------- XPATH BUILDER ----------------
-  function buildXPath(el) {
+  function buildAiXPath(el) {
       if (!el) return null;
 
       if (el.id) return "//*[@id=\\"" + el.id + "\\"]";
@@ -160,7 +160,7 @@ exports.Find_element_by_ff_js_script = `
           if (inside) targetNode = inside;
       }
 
-      const xpath_if = buildXPath(targetNode);
+      const xpath_if = buildAiXPath(targetNode);
 
       return callback({
           success: true,

package/dist/utils/newTab/newTabTracker.js

@@ -4,6 +4,9 @@ exports.newTabTracker = newTabTracker;
 async function newTabTracker(driver, stepAction, previousHandles, scriptAppender) {
     if (stepAction === "switch")
         return;
+    if (!previousHandles || previousHandles.length === 0) {
+        return;
+    }
     const currentHandle = await driver.getWindowHandle();
     const currentHandles = await driver.getWindowHandles();
     if (currentHandles.length <= previousHandles.length) {
@@ -22,12 +25,21 @@ async function newTabTracker(driver, stepAction, previousHandles, scriptAppender
                 await driver.switchToWindow(currentHandle);
                 continue;
             }
-            // Valid URL → accept it
-            scriptAppender.add(async () => ({
-                nlpName: "SwitchToWindowBasedOnURL",
-                stepInputs: [url],
-                elementsData: []
-            }));
+            const title = await driver.getTitle();
+            if (title && title.trim()) {
+                scriptAppender.add(async () => ({
+                    nlpName: "SwitchToWindowIfTitleContainsString",
+                    stepInputs: [title],
+                    elementsData: []
+                }));
+            }
+            else {
+                scriptAppender.add(async () => ({
+                    nlpName: "SwitchToWindowBasedOnURL",
+                    stepInputs: [url],
+                    elementsData: []
+                }));
+            }
             return;
         }
         catch (error) {

package/dist/utils/workers/LocatorWorkerInterface.d.ts

@@ -0,0 +1,22 @@
+import { Worker } from "worker_threads";
+import { platform } from "../../core/types/scriptTypesType.js";
+export interface ILocatorWorker {
+    id: number;
+    html: string;
+    attribute: string;
+    platform: platform;
+    sessionPath: string;
+}
+export interface PendingRequest {
+    resolve: (value: any) => void;
+    reject: (reason?: any) => void;
+}
+export interface WorkerInfo {
+    worker: Worker;
+    busy: boolean;
+    pending: Map<number, PendingRequest>;
+}
+export interface WorkerTask extends ILocatorWorker {
+    resolve: (value: any) => void;
+    reject: (reason?: any) => void;
+}

package/dist/utils/workers/LocatorWorkerInterface.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/utils/workers/LocatorWorkerPool.d.ts

@@ -0,0 +1,13 @@
+import { platform } from "../../core/types/scriptTypesType.js";
+export declare class LocatorWorkerPool {
+    private readonly sessionPath;
+    private workers;
+    private queue;
+    private requestId;
+    private readonly workerCount;
+    constructor(sessionPath: string);
+    getFireFlinkElement(html: string, attribute: string, platform: platform): Promise<any>;
+    private onWorkerMessage;
+    private dispatchTask;
+    dispose(): Promise<void>;
+}

package/dist/utils/workers/LocatorWorkerPool.js

@@ -0,0 +1,89 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LocatorWorkerPool = void 0;
+const worker_threads_1 = require("worker_threads");
+const path_1 = __importDefault(require("path"));
+class LocatorWorkerPool {
+    constructor(sessionPath) {
+        this.sessionPath = sessionPath;
+        this.workers = [];
+        this.queue = [];
+        this.requestId = 0;
+        this.workerCount = 5;
+        const workerPath = path_1.default.join(__dirname, "locatorWorker.js");
+        for (let i = 0; i < this.workerCount; i++) {
+            const worker = new worker_threads_1.Worker(workerPath);
+            const workerInfo = {
+                worker,
+                busy: false,
+                pending: new Map()
+            };
+            worker.on("message", (response) => {
+                this.onWorkerMessage(workerInfo, response);
+            });
+            worker.on("error", (error) => {
+                console.error("Worker Error:", error);
+            });
+            this.workers.push(workerInfo);
+        }
+    }
+    async getFireFlinkElement(html, attribute, platform) {
+        return new Promise((resolve, reject) => {
+            const task = {
+                id: this.requestId++,
+                html,
+                attribute,
+                platform,
+                sessionPath: this.sessionPath,
+                resolve,
+                reject
+            };
+            const freeWorker = this.workers.find(w => !w.busy);
+            if (freeWorker) {
+                this.dispatchTask(freeWorker, task);
+            }
+            else {
+                this.queue.push(task);
+            }
+        });
+    }
+    onWorkerMessage(workerInfo, response) {
+        const pending = workerInfo.pending.get(response.id);
+        if (!pending) {
+            return;
+        }
+        workerInfo.pending.delete(response.id);
+        if (response.success) {
+            pending.resolve(response.result);
+        }
+        else {
+            pending.reject(new Error(response.error));
+        }
+        workerInfo.busy = false;
+        const nextTask = this.queue.shift();
+        if (nextTask) {
+            this.dispatchTask(workerInfo, nextTask);
+        }
+    }
+    dispatchTask(workerInfo, task) {
+        workerInfo.busy = true;
+        workerInfo.pending.set(task.id, {
+            resolve: task.resolve,
+            reject: task.reject
+        });
+        workerInfo.worker.postMessage({
+            id: task.id,
+            html: task.html,
+            attribute: task.attribute,
+            platform: task.platform,
+            sessionPath: this.sessionPath,
+        });
+    }
+    async dispose() {
+        await Promise.all(this.workers.map(workerInfo => workerInfo.worker.terminate()));
+    }
+}
+exports.LocatorWorkerPool = LocatorWorkerPool;

package/dist/utils/workers/locatorWorker.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/utils/workers/locatorWorker.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const worker_threads_1 = require("worker_threads");
+const getElementsFromHTML_js_1 = require("../../fireflinkData/fireflinkLocators/parser/getElementsFromHTML.js");
+const logData_js_1 = require("../logger/logData.js");
+if (!worker_threads_1.parentPort) {
+    throw new Error("locatorWorker must be started as a Worker Thread.");
+}
+const port = worker_threads_1.parentPort;
+let loggerInitialized = false;
+port.on("message", (data) => {
+    const { id, html, attribute, platform, sessionPath } = data;
+    try {
+        if (!loggerInitialized) {
+            (0, logData_js_1.initLogger)(sessionPath);
+            loggerInitialized = true;
+        }
+        const formattedAttribute = attribute.replace("[", "//*[@");
+        const result = (0, getElementsFromHTML_js_1.getAiElementsFromHTML)({
+            locators: [
+                {
+                    name: "xpath",
+                    type: "Static",
+                    value: formattedAttribute,
+                    reference: "local",
+                    status: "NOT_USED",
+                    isRecorded: "N",
+                },
+            ],
+        }, html, platform);
+        port.postMessage({
+            id,
+            success: true,
+            result,
+        });
+    }
+    catch (error) {
+        port.postMessage({
+            id,
+            success: false,
+            error: error.message,
+        });
+    }
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ff-automationv2",
-  "version": "2.2.29",
+  "version": "2.2.30",
   "private": false,
   "type": "commonjs",
   "description": "This lib is used to automate the manual testcase",
@@ -36,6 +36,7 @@
   "devDependencies": {
     "@eslint/js": "10.0.1",
     "@types/adm-zip": "^0.5.8",
+    "@types/express": "^5.0.6",
     "@types/fs-extra": "^11.0.4",
     "@types/js-beautify": "^1.14.3",
     "@types/jsdom": "27.0.0",
@@ -71,6 +72,7 @@
     "ai": "^6.0.209",
     "axios": "^1.13.5",
     "cheerio": "1.2.0",
+    "express": "^5.2.1",
     "fast-fuzzy": "^1.12.0",
     "fastest-levenshtein": "^1.0.16",
     "google-auth": "^0.0.1",