@browserbasehq/orca 3.0.9-alpha-3 → 3.1.0-headers

package/dist/cjs/tests/integration/shadow-iframe-oopif.spec.js

@@ -0,0 +1,161 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const test_1 = require("@playwright/test");
+const v3_js_1 = require("../../lib/v3/v3.js");
+const puppeteer_core_1 = __importDefault(require("puppeteer-core"));
+const playwright_core_1 = require("playwright-core");
+const patchright_core_1 = require("patchright-core");
+const v3_dynamic_config_js_1 = require("./v3.dynamic.config.js");
+const testUtils_js_1 = require("./testUtils.js");
+async function runCase(v3, c, framework) {
+    let cleanup = null;
+    // Acquire the correct page for the requested framework
+    let page;
+    switch (framework) {
+        case "v3": {
+            const v3Page = v3.context.pages()[0];
+            await v3Page.goto(c.url, { waitUntil: "networkidle" });
+            page = v3Page;
+            break;
+        }
+        case "puppeteer": {
+            const browser = await puppeteer_core_1.default.connect({
+                browserWSEndpoint: v3.connectURL(),
+                defaultViewport: null,
+            });
+            const pages = await browser.pages();
+            const puppeteerPage = pages[0];
+            await puppeteerPage.goto(c.url, { waitUntil: "networkidle0" });
+            page = puppeteerPage;
+            cleanup = async () => {
+                try {
+                    await browser.close();
+                }
+                catch {
+                    //
+                }
+            };
+            break;
+        }
+        case "playwright": {
+            const pwBrowser = await playwright_core_1.chromium.connectOverCDP(v3.connectURL());
+            const pwContext = pwBrowser.contexts()[0];
+            const pwPage = pwContext.pages()[0];
+            await pwPage.goto(c.url, { waitUntil: "networkidle" });
+            page = pwPage;
+            cleanup = async () => {
+                try {
+                    await pwBrowser.close();
+                }
+                catch {
+                    // ignore
+                }
+            };
+            break;
+        }
+        case "patchright": {
+            const prBrowser = await patchright_core_1.chromium.connectOverCDP(v3.connectURL());
+            const prContext = prBrowser.contexts()[0];
+            const prPage = prContext.pages()[0];
+            await prPage.goto(c.url, { waitUntil: "networkidle" });
+            page = prPage;
+            cleanup = async () => {
+                try {
+                    await prBrowser.close();
+                }
+                catch {
+                    // ignore
+                }
+            };
+            break;
+        }
+    }
+    try {
+        if (!page)
+            throw new Error("Missing page for selected framework");
+        await v3.act(c.action, { page });
+        // Post-action extraction; verify expected text appears
+        const extraction = await v3.extract({ page });
+        const text = extraction.pageText ?? "";
+        for (const s of c.expectedSubstrings) {
+            (0, test_1.expect)(text.includes(s), `expected pageText to include substring: ${s}`).toBeTruthy();
+        }
+    }
+    finally {
+        await cleanup?.();
+    }
+}
+const cases = [
+    {
+        title: "Closed shadow root inside OOPIF",
+        url: "https://browserbase.github.io/stagehand-eval-sites/sites/closed-shadow-root-in-oopif/",
+        action: {
+            selector: "xpath=/html/body/main/section/iframe/html/body/shadow-demo//div/button",
+            method: "click",
+            arguments: [""],
+            description: "click button inside closed shadow root in OOPIF",
+        },
+        expectedSubstrings: ["button successfully clicked"],
+    },
+    {
+        title: "Open shadow root inside OOPIF",
+        url: "https://browserbase.github.io/stagehand-eval-sites/sites/open-shadow-root-in-oopif/",
+        action: {
+            selector: "xpath=/html/body/main/section/iframe/html/body/shadow-demo//div/button",
+            method: "click",
+            arguments: [""],
+            description: "",
+        },
+        expectedSubstrings: ["button successfully clicked"],
+    },
+    {
+        title: "OOPIF inside open shadow root",
+        url: "https://browserbase.github.io/stagehand-eval-sites/sites/oopif-in-open-shadow-dom/",
+        action: {
+            selector: "xpath=/html/body/shadow-host//section/iframe/html/body/main/section[1]/form/div/div[1]/input",
+            method: "fill",
+            arguments: ["nunya"],
+            description: "",
+        },
+        expectedSubstrings: ["nunya"],
+    },
+    {
+        title: "OOPIF inside closed shadow root",
+        url: "https://browserbase.github.io/stagehand-eval-sites/sites/oopif-in-closed-shadow-dom/",
+        action: {
+            selector: "xpath=/html/body/shadow-host//section/iframe/html/body/main/section[1]/form/div/div[1]/input",
+            method: "fill",
+            arguments: ["nunya"],
+            description: "fill input inside OOPIF",
+        },
+        expectedSubstrings: ["nunya"],
+    },
+];
+test_1.test.describe
+    .parallel("Stagehand v3: shadow <-> iframe OOPIF scenarios", () => {
+    let v3;
+    test_1.test.beforeEach(async () => {
+        v3 = new v3_js_1.V3(v3_dynamic_config_js_1.v3DynamicTestConfig);
+        await v3.init();
+    });
+    test_1.test.afterEach(async () => {
+        await (0, testUtils_js_1.closeV3)(v3);
+    });
+    const frameworks = [
+        "v3",
+        "playwright",
+        "puppeteer",
+        "patchright",
+    ];
+    for (const fw of frameworks) {
+        for (const c of cases) {
+            (0, test_1.test)(`[${fw}] ${c.title}`, async () => {
+                await runCase(v3, c, fw);
+            });
+        }
+    }
+});
+//# sourceMappingURL=shadow-iframe-oopif.spec.js.map

package/dist/cjs/tests/integration/shadow-iframe-oopif.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shadow-iframe-oopif.spec.js","sourceRoot":"","sources":["../../../../tests/integration/shadow-iframe-oopif.spec.ts"],"names":[],"mappings":"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","sourcesContent":["import { test, expect } from \"@playwright/test\";\nimport { V3 } from \"../../lib/v3/v3.js\";\nimport puppeteer from \"puppeteer-core\";\nimport { chromium as playwrightChromium } from \"playwright-core\";\nimport { chromium as patchrightChromium } from \"patchright-core\";\nimport { Action } from \"../../lib/v3/types/public/methods.js\";\nimport { AnyPage } from \"../../lib/v3/types/public/page.js\";\nimport { v3DynamicTestConfig } from \"./v3.dynamic.config.js\";\nimport { closeV3 } from \"./testUtils.js\";\n\n/**\n * IMPORTANT:\n * - We create a single V3 instance/test to avoid cross-test state. Increase parallelism later if needed.\n * - We assert an *effect* when feasible (e.g. input value). For pure clicks we assert no thrown error.\n */\n\ntype Case = {\n  title: string;\n  url: string;\n  action: Action;\n  expectedSubstrings: string[]; // check v3.extract().pageText contains these\n};\n\ntype Framework = \"v3\" | \"puppeteer\" | \"playwright\" | \"patchright\";\n\nasync function runCase(v3: V3, c: Case, framework: Framework): Promise<void> {\n  let cleanup: (() => Promise<void> | void) | null = null;\n\n  // Acquire the correct page for the requested framework\n  let page: AnyPage | undefined;\n  switch (framework) {\n    case \"v3\": {\n      const v3Page = v3.context.pages()[0];\n      await v3Page.goto(c.url, { waitUntil: \"networkidle\" });\n      page = v3Page;\n      break;\n    }\n    case \"puppeteer\": {\n      const browser = await puppeteer.connect({\n        browserWSEndpoint: v3.connectURL(),\n        defaultViewport: null,\n      });\n      const pages = await browser.pages();\n      const puppeteerPage = pages[0];\n      await puppeteerPage.goto(c.url, { waitUntil: \"networkidle0\" });\n      page = puppeteerPage;\n      cleanup = async () => {\n        try {\n          await browser.close();\n        } catch {\n          //\n        }\n      };\n      break;\n    }\n    case \"playwright\": {\n      const pwBrowser = await playwrightChromium.connectOverCDP(\n        v3.connectURL(),\n      );\n      const pwContext = pwBrowser.contexts()[0];\n      const pwPage = pwContext.pages()[0];\n      await pwPage.goto(c.url, { waitUntil: \"networkidle\" as never });\n      page = pwPage as unknown as AnyPage;\n      cleanup = async () => {\n        try {\n          await pwBrowser.close();\n        } catch {\n          // ignore\n        }\n      };\n      break;\n    }\n    case \"patchright\": {\n      const prBrowser = await patchrightChromium.connectOverCDP(\n        v3.connectURL(),\n      );\n      const prContext = prBrowser.contexts()[0];\n      const prPage = prContext.pages()[0];\n      await prPage.goto(c.url, { waitUntil: \"networkidle\" as never });\n      page = prPage as unknown as AnyPage;\n      cleanup = async () => {\n        try {\n          await prBrowser.close();\n        } catch {\n          // ignore\n        }\n      };\n      break;\n    }\n  }\n\n  try {\n    if (!page) throw new Error(\"Missing page for selected framework\");\n    await v3.act(c.action, { page });\n    // Post-action extraction; verify expected text appears\n    const extraction = await v3.extract({ page });\n    const text = extraction.pageText ?? \"\";\n    for (const s of c.expectedSubstrings) {\n      expect(\n        text.includes(s),\n        `expected pageText to include substring: ${s}`,\n      ).toBeTruthy();\n    }\n  } finally {\n    await cleanup?.();\n  }\n}\n\nconst cases: Case[] = [\n  {\n    title: \"Closed shadow root inside OOPIF\",\n    url: \"https://browserbase.github.io/stagehand-eval-sites/sites/closed-shadow-root-in-oopif/\",\n    action: {\n      selector:\n        \"xpath=/html/body/main/section/iframe/html/body/shadow-demo//div/button\",\n      method: \"click\",\n      arguments: [\"\"],\n      description: \"click button inside closed shadow root in OOPIF\",\n    },\n    expectedSubstrings: [\"button successfully clicked\"],\n  },\n  {\n    title: \"Open shadow root inside OOPIF\",\n    url: \"https://browserbase.github.io/stagehand-eval-sites/sites/open-shadow-root-in-oopif/\",\n    action: {\n      selector:\n        \"xpath=/html/body/main/section/iframe/html/body/shadow-demo//div/button\",\n      method: \"click\",\n      arguments: [\"\"],\n      description: \"\",\n    },\n    expectedSubstrings: [\"button successfully clicked\"],\n  },\n  {\n    title: \"OOPIF inside open shadow root\",\n    url: \"https://browserbase.github.io/stagehand-eval-sites/sites/oopif-in-open-shadow-dom/\",\n    action: {\n      selector:\n        \"xpath=/html/body/shadow-host//section/iframe/html/body/main/section[1]/form/div/div[1]/input\",\n      method: \"fill\",\n      arguments: [\"nunya\"],\n      description: \"\",\n    },\n    expectedSubstrings: [\"nunya\"],\n  },\n  {\n    title: \"OOPIF inside closed shadow root\",\n    url: \"https://browserbase.github.io/stagehand-eval-sites/sites/oopif-in-closed-shadow-dom/\",\n    action: {\n      selector:\n        \"xpath=/html/body/shadow-host//section/iframe/html/body/main/section[1]/form/div/div[1]/input\",\n      method: \"fill\",\n      arguments: [\"nunya\"],\n      description: \"fill input inside OOPIF\",\n    },\n    expectedSubstrings: [\"nunya\"],\n  },\n];\n\ntest.describe\n  .parallel(\"Stagehand v3: shadow <-> iframe OOPIF scenarios\", () => {\n  let v3: V3;\n\n  test.beforeEach(async () => {\n    v3 = new V3(v3DynamicTestConfig);\n    await v3.init();\n  });\n\n  test.afterEach(async () => {\n    await closeV3(v3);\n  });\n\n  const frameworks: Framework[] = [\n    \"v3\",\n    \"playwright\",\n    \"puppeteer\",\n    \"patchright\",\n  ];\n  for (const fw of frameworks) {\n    for (const c of cases) {\n      test(`[${fw}] ${c.title}`, async () => {\n        await runCase(v3, c, fw);\n      });\n    }\n  }\n});\n"]}

package/dist/cjs/tests/integration/shadow-iframe-spif.spec.d.ts

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

package/dist/cjs/tests/integration/shadow-iframe-spif.spec.js

@@ -0,0 +1,160 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const test_1 = require("@playwright/test");
+const v3_js_1 = require("../../lib/v3/v3.js");
+const puppeteer_core_1 = __importDefault(require("puppeteer-core"));
+const playwright_core_1 = require("playwright-core");
+const patchright_core_1 = require("patchright-core");
+const v3_dynamic_config_js_1 = require("./v3.dynamic.config.js");
+const testUtils_js_1 = require("./testUtils.js");
+async function runCase(v3, c, framework) {
+    let cleanup = null;
+    // Acquire the correct page for the requested framework
+    let page;
+    switch (framework) {
+        case "v3": {
+            const v3Page = v3.context.pages()[0];
+            await v3Page.goto(c.url, { waitUntil: "networkidle" });
+            page = v3Page;
+            break;
+        }
+        case "puppeteer": {
+            const browser = await puppeteer_core_1.default.connect({
+                browserWSEndpoint: v3.connectURL(),
+                defaultViewport: null,
+            });
+            const pages = await browser.pages();
+            const puppeteerPage = pages[0];
+            await puppeteerPage.goto(c.url, { waitUntil: "networkidle0" });
+            page = puppeteerPage;
+            cleanup = async () => {
+                try {
+                    await browser.close();
+                }
+                catch {
+                    //
+                }
+            };
+            break;
+        }
+        case "playwright": {
+            const pwBrowser = await playwright_core_1.chromium.connectOverCDP(v3.connectURL());
+            const pwContext = pwBrowser.contexts()[0];
+            const pwPage = pwContext.pages()[0];
+            await pwPage.goto(c.url, { waitUntil: "networkidle" });
+            page = pwPage;
+            cleanup = async () => {
+                try {
+                    await pwBrowser.close();
+                }
+                catch {
+                    // ignore
+                }
+            };
+            break;
+        }
+        case "patchright": {
+            const prBrowser = await patchright_core_1.chromium.connectOverCDP(v3.connectURL());
+            const prContext = prBrowser.contexts()[0];
+            const prPage = prContext.pages()[0];
+            await prPage.goto(c.url, { waitUntil: "networkidle" });
+            page = prPage;
+            cleanup = async () => {
+                try {
+                    await prBrowser.close();
+                }
+                catch {
+                    // ignore
+                }
+            };
+            break;
+        }
+    }
+    try {
+        if (!page)
+            throw new Error("Missing page for selected framework");
+        await v3.act(c.action, { page });
+        // Post-action extraction; verify expected text appears
+        const extraction = await v3.extract({ page });
+        const text = extraction.pageText ?? "";
+        for (const s of c.expectedSubstrings) {
+            (0, test_1.expect)(text.includes(s), `expected pageText to include substring: ${s}`).toBeTruthy();
+        }
+    }
+    finally {
+        await cleanup?.();
+    }
+}
+const cases = [
+    {
+        title: "Open shadow root inside SPIF",
+        url: "https://browserbase.github.io/stagehand-eval-sites/sites/open-shadow-root-in-spif/",
+        action: {
+            selector: "xpath=/html/body/main/section/iframe/html/body/shadow-demo//div/button",
+            method: "click",
+            arguments: [""],
+            description: "",
+        },
+        expectedSubstrings: ["button successfully clicked"],
+    },
+    {
+        title: "Closed shadow root inside SPIF",
+        url: "https://browserbase.github.io/stagehand-eval-sites/sites/closed-shadow-dom-in-spif/",
+        action: {
+            selector: "xpath=/html/body/div/iframe/html/body/shadow-demo//div/button",
+            method: "click",
+            arguments: [""],
+            description: "",
+        },
+        expectedSubstrings: ["button successfully clicked"],
+    },
+    {
+        title: "SPIF inside closed shadow root",
+        url: "https://browserbase.github.io/stagehand-eval-sites/sites/spif-in-closed-shadow-dom/",
+        action: {
+            selector: "xpath=/html/body/shadow-host//div/iframe/html/body/button",
+            method: "click",
+            arguments: [""],
+            description: "",
+        },
+        expectedSubstrings: ["button successfully clicked"],
+    },
+    {
+        title: "SPIF inside open shadow root",
+        url: "https://browserbase.github.io/stagehand-eval-sites/sites/spif-in-open-shadow-dom/",
+        action: {
+            selector: "xpath=/html/body/shadow-host//div/iframe/html/body/button",
+            method: "click",
+            arguments: [""],
+            description: "click button inside SPIF under open shadow",
+        },
+        expectedSubstrings: ["button successfully clicked"],
+    },
+];
+test_1.test.describe.parallel("Stagehand v3: shadow <-> iframe SPIF scenarios", () => {
+    let v3;
+    test_1.test.beforeEach(async () => {
+        v3 = new v3_js_1.V3(v3_dynamic_config_js_1.v3DynamicTestConfig);
+        await v3.init();
+    });
+    test_1.test.afterEach(async () => {
+        await (0, testUtils_js_1.closeV3)(v3);
+    });
+    const frameworks = [
+        "v3",
+        "playwright",
+        "puppeteer",
+        "patchright",
+    ];
+    for (const fw of frameworks) {
+        for (const c of cases) {
+            (0, test_1.test)(`[${fw}] ${c.title}`, async () => {
+                await runCase(v3, c, fw);
+            });
+        }
+    }
+});
+//# sourceMappingURL=shadow-iframe-spif.spec.js.map

package/dist/cjs/tests/integration/shadow-iframe-spif.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shadow-iframe-spif.spec.js","sourceRoot":"","sources":["../../../../tests/integration/shadow-iframe-spif.spec.ts"],"names":[],"mappings":"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","sourcesContent":["import { test, expect } from \"@playwright/test\";\nimport { V3 } from \"../../lib/v3/v3.js\";\nimport puppeteer from \"puppeteer-core\";\nimport { chromium as playwrightChromium } from \"playwright-core\";\nimport { chromium as patchrightChromium } from \"patchright-core\";\nimport { Action } from \"../../lib/v3/types/public/methods.js\";\nimport { AnyPage } from \"../../lib/v3/types/public/page.js\";\nimport { v3DynamicTestConfig } from \"./v3.dynamic.config.js\";\nimport { closeV3 } from \"./testUtils.js\";\n\n/**\n * IMPORTANT:\n * - We create a single V3 instance/test to avoid cross-test state. Increase parallelism later if needed.\n * - We assert an *effect* when feasible (e.g. input value). For pure clicks we assert no thrown error.\n */\n\ntype Case = {\n  title: string;\n  url: string;\n  action: Action;\n  expectedSubstrings: string[]; // check v3.extract().pageText contains these\n};\n\ntype Framework = \"v3\" | \"puppeteer\" | \"playwright\" | \"patchright\";\n\nasync function runCase(v3: V3, c: Case, framework: Framework): Promise<void> {\n  let cleanup: (() => Promise<void> | void) | null = null;\n\n  // Acquire the correct page for the requested framework\n  let page: AnyPage | undefined;\n  switch (framework) {\n    case \"v3\": {\n      const v3Page = v3.context.pages()[0];\n      await v3Page.goto(c.url, { waitUntil: \"networkidle\" });\n      page = v3Page;\n      break;\n    }\n    case \"puppeteer\": {\n      const browser = await puppeteer.connect({\n        browserWSEndpoint: v3.connectURL(),\n        defaultViewport: null,\n      });\n      const pages = await browser.pages();\n      const puppeteerPage = pages[0];\n      await puppeteerPage.goto(c.url, { waitUntil: \"networkidle0\" });\n      page = puppeteerPage;\n      cleanup = async () => {\n        try {\n          await browser.close();\n        } catch {\n          //\n        }\n      };\n      break;\n    }\n    case \"playwright\": {\n      const pwBrowser = await playwrightChromium.connectOverCDP(\n        v3.connectURL(),\n      );\n      const pwContext = pwBrowser.contexts()[0];\n      const pwPage = pwContext.pages()[0];\n      await pwPage.goto(c.url, { waitUntil: \"networkidle\" as never });\n      page = pwPage as unknown as AnyPage;\n      cleanup = async () => {\n        try {\n          await pwBrowser.close();\n        } catch {\n          // ignore\n        }\n      };\n      break;\n    }\n    case \"patchright\": {\n      const prBrowser = await patchrightChromium.connectOverCDP(\n        v3.connectURL(),\n      );\n      const prContext = prBrowser.contexts()[0];\n      const prPage = prContext.pages()[0];\n      await prPage.goto(c.url, { waitUntil: \"networkidle\" as never });\n      page = prPage as unknown as AnyPage;\n      cleanup = async () => {\n        try {\n          await prBrowser.close();\n        } catch {\n          // ignore\n        }\n      };\n      break;\n    }\n  }\n\n  try {\n    if (!page) throw new Error(\"Missing page for selected framework\");\n    await v3.act(c.action, { page });\n    // Post-action extraction; verify expected text appears\n    const extraction = await v3.extract({ page });\n    const text = extraction.pageText ?? \"\";\n    for (const s of c.expectedSubstrings) {\n      expect(\n        text.includes(s),\n        `expected pageText to include substring: ${s}`,\n      ).toBeTruthy();\n    }\n  } finally {\n    await cleanup?.();\n  }\n}\n\nconst cases: Case[] = [\n  {\n    title: \"Open shadow root inside SPIF\",\n    url: \"https://browserbase.github.io/stagehand-eval-sites/sites/open-shadow-root-in-spif/\",\n    action: {\n      selector:\n        \"xpath=/html/body/main/section/iframe/html/body/shadow-demo//div/button\",\n      method: \"click\",\n      arguments: [\"\"],\n      description: \"\",\n    },\n    expectedSubstrings: [\"button successfully clicked\"],\n  },\n  {\n    title: \"Closed shadow root inside SPIF\",\n    url: \"https://browserbase.github.io/stagehand-eval-sites/sites/closed-shadow-dom-in-spif/\",\n    action: {\n      selector: \"xpath=/html/body/div/iframe/html/body/shadow-demo//div/button\",\n      method: \"click\",\n      arguments: [\"\"],\n      description: \"\",\n    },\n    expectedSubstrings: [\"button successfully clicked\"],\n  },\n  {\n    title: \"SPIF inside closed shadow root\",\n    url: \"https://browserbase.github.io/stagehand-eval-sites/sites/spif-in-closed-shadow-dom/\",\n    action: {\n      selector: \"xpath=/html/body/shadow-host//div/iframe/html/body/button\",\n      method: \"click\",\n      arguments: [\"\"],\n      description: \"\",\n    },\n    expectedSubstrings: [\"button successfully clicked\"],\n  },\n  {\n    title: \"SPIF inside open shadow root\",\n    url: \"https://browserbase.github.io/stagehand-eval-sites/sites/spif-in-open-shadow-dom/\",\n    action: {\n      selector: \"xpath=/html/body/shadow-host//div/iframe/html/body/button\",\n      method: \"click\",\n      arguments: [\"\"],\n      description: \"click button inside SPIF under open shadow\",\n    },\n    expectedSubstrings: [\"button successfully clicked\"],\n  },\n];\n\ntest.describe.parallel(\"Stagehand v3: shadow <-> iframe SPIF scenarios\", () => {\n  let v3: V3;\n\n  test.beforeEach(async () => {\n    v3 = new V3(v3DynamicTestConfig);\n    await v3.init();\n  });\n\n  test.afterEach(async () => {\n    await closeV3(v3);\n  });\n\n  const frameworks: Framework[] = [\n    \"v3\",\n    \"playwright\",\n    \"puppeteer\",\n    \"patchright\",\n  ];\n  for (const fw of frameworks) {\n    for (const c of cases) {\n      test(`[${fw}] ${c.title}`, async () => {\n        await runCase(v3, c, fw);\n      });\n    }\n  }\n});\n"]}

package/dist/cjs/tests/integration/testUtils.d.ts

@@ -0,0 +1,7 @@
+import type { V3 } from "../../lib/v3/v3.js";
+/**
+ * Races a promise against a timeout.
+ * Resolves to the promise value or "timeout" if the deadline expires.
+ */
+export declare function raceTimeout<T>(promise: Promise<T>, ms: number): Promise<T | "timeout">;
+export declare function closeV3(v3?: V3 | null): Promise<void>;

package/dist/cjs/tests/integration/testUtils.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.raceTimeout = raceTimeout;
+exports.closeV3 = closeV3;
+/**
+ * Races a promise against a timeout.
+ * Resolves to the promise value or "timeout" if the deadline expires.
+ */
+function raceTimeout(promise, ms) {
+    let timer;
+    const timeout = new Promise((resolve) => {
+        timer = setTimeout(() => resolve("timeout"), ms);
+    });
+    return Promise.race([promise, timeout]).finally(() => clearTimeout(timer));
+}
+const CLOSE_TIMEOUT_MS = 5_000;
+async function settleWithTimeout(promise, timeoutMs) {
+    let timeoutId;
+    const timeout = new Promise((resolve) => {
+        timeoutId = setTimeout(resolve, timeoutMs);
+    });
+    try {
+        await Promise.race([promise.catch(() => { }), timeout]);
+    }
+    finally {
+        if (timeoutId)
+            clearTimeout(timeoutId);
+    }
+}
+async function closeV3(v3) {
+    if (!v3)
+        return;
+    const isBrowserbase = v3.isBrowserbase;
+    if (isBrowserbase) {
+        try {
+            await settleWithTimeout(v3.context.conn.send("Browser.close"), CLOSE_TIMEOUT_MS);
+        }
+        catch {
+            // best-effort cleanup
+        }
+    }
+    await settleWithTimeout(v3.close(), CLOSE_TIMEOUT_MS);
+}
+//# sourceMappingURL=testUtils.js.map

package/dist/cjs/tests/integration/testUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testUtils.js","sourceRoot":"","sources":["../../../../tests/integration/testUtils.ts"],"names":[],"mappings":";;AAMA,kCASC;AAmBD,0BAeC;AA/CD;;;GAGG;AACH,SAAgB,WAAW,CACzB,OAAmB,EACnB,EAAU;IAEV,IAAI,KAAoC,CAAC;IACzC,MAAM,OAAO,GAAG,IAAI,OAAO,CAAY,CAAC,OAAO,EAAE,EAAE;QACjD,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,EAAE,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;IACH,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC;AAC7E,CAAC;AAED,MAAM,gBAAgB,GAAG,KAAK,CAAC;AAE/B,KAAK,UAAU,iBAAiB,CAC9B,OAAyB,EACzB,SAAiB;IAEjB,IAAI,SAAqC,CAAC;IAC1C,MAAM,OAAO,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;QAC5C,SAAS,GAAG,UAAU,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;IACH,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;IACzD,CAAC;YAAS,CAAC;QACT,IAAI,SAAS;YAAE,YAAY,CAAC,SAAS,CAAC,CAAC;IACzC,CAAC;AACH,CAAC;AAEM,KAAK,UAAU,OAAO,CAAC,EAAc;IAC1C,IAAI,CAAC,EAAE;QAAE,OAAO;IAChB,MAAM,aAAa,GAAG,EAAE,CAAC,aAAa,CAAC;IACvC,IAAI,aAAa,EAAE,CAAC;QAClB,IAAI,CAAC;YACH,MAAM,iBAAiB,CACrB,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,EACrC,gBAAgB,CACjB,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,sBAAsB;QACxB,CAAC;IACH,CAAC;IAED,MAAM,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,EAAE,gBAAgB,CAAC,CAAC;AACxD,CAAC","sourcesContent":["import type { V3 } from \"../../lib/v3/v3.js\";\n\n/**\n * Races a promise against a timeout.\n * Resolves to the promise value or \"timeout\" if the deadline expires.\n */\nexport function raceTimeout<T>(\n  promise: Promise<T>,\n  ms: number,\n): Promise<T | \"timeout\"> {\n  let timer: ReturnType<typeof setTimeout>;\n  const timeout = new Promise<\"timeout\">((resolve) => {\n    timer = setTimeout(() => resolve(\"timeout\"), ms);\n  });\n  return Promise.race([promise, timeout]).finally(() => clearTimeout(timer));\n}\n\nconst CLOSE_TIMEOUT_MS = 5_000;\n\nasync function settleWithTimeout(\n  promise: Promise<unknown>,\n  timeoutMs: number,\n): Promise<void> {\n  let timeoutId: NodeJS.Timeout | undefined;\n  const timeout = new Promise<void>((resolve) => {\n    timeoutId = setTimeout(resolve, timeoutMs);\n  });\n  try {\n    await Promise.race([promise.catch(() => {}), timeout]);\n  } finally {\n    if (timeoutId) clearTimeout(timeoutId);\n  }\n}\n\nexport async function closeV3(v3?: V3 | null): Promise<void> {\n  if (!v3) return;\n  const isBrowserbase = v3.isBrowserbase;\n  if (isBrowserbase) {\n    try {\n      await settleWithTimeout(\n        v3.context.conn.send(\"Browser.close\"),\n        CLOSE_TIMEOUT_MS,\n      );\n    } catch {\n      // best-effort cleanup\n    }\n  }\n\n  await settleWithTimeout(v3.close(), CLOSE_TIMEOUT_MS);\n}\n"]}

package/dist/cjs/tests/integration/text-selector-innermost.spec.d.ts

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

package/dist/cjs/tests/integration/text-selector-innermost.spec.js

@@ -0,0 +1,105 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const test_1 = require("@playwright/test");
+const v3_js_1 = require("../../lib/v3/v3.js");
+const v3_dynamic_config_js_1 = require("./v3.dynamic.config.js");
+const testUtils_js_1 = require("./testUtils.js");
+test_1.test.describe("Text selector innermost element matching", () => {
+    let v3;
+    test_1.test.beforeEach(async () => {
+        v3 = new v3_js_1.V3(v3_dynamic_config_js_1.v3DynamicTestConfig);
+        await v3.init();
+    });
+    test_1.test.afterEach(async () => {
+        await (0, testUtils_js_1.closeV3)(v3);
+    });
+    (0, test_1.test)("text selector matches only innermost elements", async () => {
+        const page = v3.context.pages()[0];
+        await page.goto("data:text/html," +
+            encodeURIComponent(`
+        <div id="outer">
+          <span id="middle">
+            <button id="inner">Click me</button>
+          </span>
+        </div>
+      `));
+        // Only the button should be counted, not the parent elements
+        const count = await page.mainFrame().locator("text=Click me").count();
+        (0, test_1.expect)(count).toBe(1);
+        // Verify it finds the button element specifically
+        const session = page.mainFrame().session;
+        const { executionContextId } = await session.send("Page.createIsolatedWorld", {
+            frameId: page.mainFrame().frameId,
+            worldName: "test-world",
+        });
+        const evalRes = await session.send("Runtime.evaluate", {
+            expression: `(() => {
+          const candidates = [];
+          const iter = document.createNodeIterator(document.documentElement, NodeFilter.SHOW_ELEMENT);
+          let n;
+          while ((n = iter.nextNode())) {
+            const el = n;
+            const t = (el.innerText ?? el.textContent ?? '').trim();
+            if (t && t.includes("Click me")) {
+              candidates.push(el);
+            }
+          }
+          
+          // Find innermost
+          for (const candidate of candidates) {
+            let isInnermost = true;
+            for (const other of candidates) {
+              if (candidate !== other && candidate.contains(other)) {
+                isInnermost = false;
+                break;
+              }
+            }
+            if (isInnermost) return candidate.id;
+          }
+          return null;
+        })()`,
+            contextId: executionContextId,
+            returnByValue: true,
+        });
+        (0, test_1.expect)(evalRes.result.value).toBe("inner");
+    });
+    (0, test_1.test)("multiple innermost elements with same text", async () => {
+        const page = v3.context.pages()[0];
+        await page.goto("data:text/html," +
+            encodeURIComponent(`
+        <div>
+          <button>Submit</button>
+          <span>Some other content</span>
+          <button>Submit</button>
+        </div>
+        <div>
+          <a href="#">Submit</a>
+        </div>
+      `));
+        // Should find all three innermost elements (2 buttons + 1 link)
+        const count = await page.mainFrame().locator("text=Submit").count();
+        (0, test_1.expect)(count).toBe(3);
+    });
+    (0, test_1.test)("nested text with different innermost elements", async () => {
+        const page = v3.context.pages()[0];
+        await page.goto("data:text/html," +
+            encodeURIComponent(`
+        <div id="parent">
+          Hello <span id="child">World</span>
+        </div>
+      `));
+        // "Hello" is only in the parent div
+        const helloCount = await page.mainFrame().locator("text=Hello").count();
+        (0, test_1.expect)(helloCount).toBe(1); // Only the div
+        // "World" is only in the span
+        const worldCount = await page.mainFrame().locator("text=World").count();
+        (0, test_1.expect)(worldCount).toBe(1); // Only the span
+        // "Hello World" matches only the parent div (as it's the innermost containing both words)
+        const bothCount = await page
+            .mainFrame()
+            .locator("text=Hello World")
+            .count();
+        (0, test_1.expect)(bothCount).toBe(1); // Only the div
+    });
+});
+//# sourceMappingURL=text-selector-innermost.spec.js.map

package/dist/cjs/tests/integration/text-selector-innermost.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-selector-innermost.spec.js","sourceRoot":"","sources":["../../../../tests/integration/text-selector-innermost.spec.ts"],"names":[],"mappings":";;AAAA,2CAAgD;AAEhD,8CAAwC;AACxC,iEAA6D;AAC7D,iDAAyC;AAEzC,WAAI,CAAC,QAAQ,CAAC,0CAA0C,EAAE,GAAG,EAAE;IAC7D,IAAI,EAAM,CAAC;IAEX,WAAI,CAAC,UAAU,CAAC,KAAK,IAAI,EAAE;QACzB,EAAE,GAAG,IAAI,UAAE,CAAC,0CAAmB,CAAC,CAAC;QACjC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC;IAClB,CAAC,CAAC,CAAC;IAEH,WAAI,CAAC,SAAS,CAAC,KAAK,IAAI,EAAE;QACxB,MAAM,IAAA,sBAAO,EAAC,EAAE,CAAC,CAAC;IACpB,CAAC,CAAC,CAAC;IAEH,IAAA,WAAI,EAAC,+CAA+C,EAAE,KAAK,IAAI,EAAE;QAC/D,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;QAEnC,MAAM,IAAI,CAAC,IAAI,CACb,iBAAiB;YACf,kBAAkB,CAAC;;;;;;OAMpB,CAAC,CACH,CAAC;QAEF,6DAA6D;QAC7D,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,KAAK,EAAE,CAAC;QACtE,IAAA,aAAM,EAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAEtB,kDAAkD;QAClD,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC,OAAO,CAAC;QACzC,MAAM,EAAE,kBAAkB,EAAE,GAAG,MAAM,OAAO,CAAC,IAAI,CAE9C,0BAA0B,EAAE;YAC7B,OAAO,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,OAAO;YACjC,SAAS,EAAE,YAAY;SACxB,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,IAAI,CAChC,kBAAkB,EAClB;YACE,UAAU,EAAE;;;;;;;;;;;;;;;;;;;;;;;;aAwBP;YACL,SAAS,EAAE,kBAAkB;YAC7B,aAAa,EAAE,IAAI;SACpB,CACF,CAAC;QAEF,IAAA,aAAM,EAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;IAEH,IAAA,WAAI,EAAC,4CAA4C,EAAE,KAAK,IAAI,EAAE;QAC5D,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;QAEnC,MAAM,IAAI,CAAC,IAAI,CACb,iBAAiB;YACf,kBAAkB,CAAC;;;;;;;;;OASpB,CAAC,CACH,CAAC;QAEF,gEAAgE;QAChE,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,KAAK,EAAE,CAAC;QACpE,IAAA,aAAM,EAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACxB,CAAC,CAAC,CAAC;IAEH,IAAA,WAAI,EAAC,+CAA+C,EAAE,KAAK,IAAI,EAAE;QAC/D,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;QAEnC,MAAM,IAAI,CAAC,IAAI,CACb,iBAAiB;YACf,kBAAkB,CAAC;;;;OAIpB,CAAC,CACH,CAAC;QAEF,oCAAoC;QACpC,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,KAAK,EAAE,CAAC;QACxE,IAAA,aAAM,EAAC,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,eAAe;QAE3C,8BAA8B;QAC9B,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,KAAK,EAAE,CAAC;QACxE,IAAA,aAAM,EAAC,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,gBAAgB;QAE5C,0FAA0F;QAC1F,MAAM,SAAS,GAAG,MAAM,IAAI;aACzB,SAAS,EAAE;aACX,OAAO,CAAC,kBAAkB,CAAC;aAC3B,KAAK,EAAE,CAAC;QACX,IAAA,aAAM,EAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,eAAe;IAC5C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC","sourcesContent":["import { expect, test } from \"@playwright/test\";\nimport { Protocol } from \"devtools-protocol\";\nimport { V3 } from \"../../lib/v3/v3.js\";\nimport { v3DynamicTestConfig } from \"./v3.dynamic.config.js\";\nimport { closeV3 } from \"./testUtils.js\";\n\ntest.describe(\"Text selector innermost element matching\", () => {\n  let v3: V3;\n\n  test.beforeEach(async () => {\n    v3 = new V3(v3DynamicTestConfig);\n    await v3.init();\n  });\n\n  test.afterEach(async () => {\n    await closeV3(v3);\n  });\n\n  test(\"text selector matches only innermost elements\", async () => {\n    const page = v3.context.pages()[0];\n\n    await page.goto(\n      \"data:text/html,\" +\n        encodeURIComponent(`\n        <div id=\"outer\">\n          <span id=\"middle\">\n            <button id=\"inner\">Click me</button>\n          </span>\n        </div>\n      `),\n    );\n\n    // Only the button should be counted, not the parent elements\n    const count = await page.mainFrame().locator(\"text=Click me\").count();\n    expect(count).toBe(1);\n\n    // Verify it finds the button element specifically\n    const session = page.mainFrame().session;\n    const { executionContextId } = await session.send<{\n      executionContextId: number;\n    }>(\"Page.createIsolatedWorld\", {\n      frameId: page.mainFrame().frameId,\n      worldName: \"test-world\",\n    });\n\n    const evalRes = await session.send<Protocol.Runtime.EvaluateResponse>(\n      \"Runtime.evaluate\",\n      {\n        expression: `(() => {\n          const candidates = [];\n          const iter = document.createNodeIterator(document.documentElement, NodeFilter.SHOW_ELEMENT);\n          let n;\n          while ((n = iter.nextNode())) {\n            const el = n;\n            const t = (el.innerText ?? el.textContent ?? '').trim();\n            if (t && t.includes(\"Click me\")) {\n              candidates.push(el);\n            }\n          }\n          \n          // Find innermost\n          for (const candidate of candidates) {\n            let isInnermost = true;\n            for (const other of candidates) {\n              if (candidate !== other && candidate.contains(other)) {\n                isInnermost = false;\n                break;\n              }\n            }\n            if (isInnermost) return candidate.id;\n          }\n          return null;\n        })()`,\n        contextId: executionContextId,\n        returnByValue: true,\n      },\n    );\n\n    expect(evalRes.result.value).toBe(\"inner\");\n  });\n\n  test(\"multiple innermost elements with same text\", async () => {\n    const page = v3.context.pages()[0];\n\n    await page.goto(\n      \"data:text/html,\" +\n        encodeURIComponent(`\n        <div>\n          <button>Submit</button>\n          <span>Some other content</span>\n          <button>Submit</button>\n        </div>\n        <div>\n          <a href=\"#\">Submit</a>\n        </div>\n      `),\n    );\n\n    // Should find all three innermost elements (2 buttons + 1 link)\n    const count = await page.mainFrame().locator(\"text=Submit\").count();\n    expect(count).toBe(3);\n  });\n\n  test(\"nested text with different innermost elements\", async () => {\n    const page = v3.context.pages()[0];\n\n    await page.goto(\n      \"data:text/html,\" +\n        encodeURIComponent(`\n        <div id=\"parent\">\n          Hello <span id=\"child\">World</span>\n        </div>\n      `),\n    );\n\n    // \"Hello\" is only in the parent div\n    const helloCount = await page.mainFrame().locator(\"text=Hello\").count();\n    expect(helloCount).toBe(1); // Only the div\n\n    // \"World\" is only in the span\n    const worldCount = await page.mainFrame().locator(\"text=World\").count();\n    expect(worldCount).toBe(1); // Only the span\n\n    // \"Hello World\" matches only the parent div (as it's the innermost containing both words)\n    const bothCount = await page\n      .mainFrame()\n      .locator(\"text=Hello World\")\n      .count();\n    expect(bothCount).toBe(1); // Only the div\n  });\n});\n"]}

package/dist/cjs/tests/integration/timeouts.spec.d.ts

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