@browserbasehq/orca 3.4.0-preview-3 → 3.4.0-preview-5

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

@@ -1,40 +0,0 @@
-import type { V3 } from "../../lib/v3/v3.js";
-import type { LanguageModelV2CallOptions, LanguageModelV2Content, LanguageModelV2FinishReason, LanguageModelV2Usage } from "@ai-sdk/provider";
-import { AISdkClient } from "../../lib/v3/llm/aisdk.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>;
-type JsonResponseKey = "act" | "Observation" | "Metadata" | "Extraction" | "default";
-type JsonResponseValue = Record<string, unknown> | ((options: LanguageModelV2CallOptions) => Record<string, unknown>);
-type JsonResponseScript = JsonResponseValue | JsonResponseValue[];
-type GenerateResponseValue = {
-    content: LanguageModelV2Content[];
-    finishReason?: LanguageModelV2FinishReason;
-    usage?: Partial<LanguageModelV2Usage>;
-} | ((options: LanguageModelV2CallOptions) => {
-    content: LanguageModelV2Content[];
-    finishReason?: LanguageModelV2FinishReason;
-    usage?: Partial<LanguageModelV2Usage>;
-});
-export declare function promptToText(prompt: LanguageModelV2CallOptions["prompt"]): string;
-export declare function findEncodedIdForText(options: LanguageModelV2CallOptions, text: string): string;
-export declare function findLastEncodedId(options: LanguageModelV2CallOptions): string;
-export declare function toolCallResponse(toolName: string, input: Record<string, unknown>, toolCallId?: string): {
-    content: LanguageModelV2Content[];
-    finishReason: LanguageModelV2FinishReason;
-    usage: LanguageModelV2Usage;
-};
-export declare function doneToolResponse(reasoning?: string, taskComplete?: boolean, toolCallId?: string): {
-    content: LanguageModelV2Content[];
-    finishReason: LanguageModelV2FinishReason;
-    usage: LanguageModelV2Usage;
-};
-export declare function createScriptedAisdkTestLlmClient(options?: {
-    modelId?: string;
-    jsonResponses?: Partial<Record<JsonResponseKey, JsonResponseScript>>;
-    generateResponses?: GenerateResponseValue[];
-}): AISdkClient;
-export {};

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

@@ -1,188 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.raceTimeout = raceTimeout;
-exports.closeV3 = closeV3;
-exports.promptToText = promptToText;
-exports.findEncodedIdForText = findEncodedIdForText;
-exports.findLastEncodedId = findLastEncodedId;
-exports.toolCallResponse = toolCallResponse;
-exports.doneToolResponse = doneToolResponse;
-exports.createScriptedAisdkTestLlmClient = createScriptedAisdkTestLlmClient;
-const aisdk_js_1 = require("../../lib/v3/llm/aisdk.js");
-/**
- * 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);
-}
-const DEFAULT_USAGE = {
-    inputTokens: 1,
-    outputTokens: 1,
-    totalTokens: 2,
-    reasoningTokens: 0,
-    cachedInputTokens: 0,
-};
-const mergeUsage = (usage) => ({
-    ...DEFAULT_USAGE,
-    ...(usage ?? {}),
-});
-function consumeScriptValue(value, fallback) {
-    if (!Array.isArray(value)) {
-        return value ?? fallback;
-    }
-    if (value.length <= 1) {
-        return value[0] ?? fallback;
-    }
-    return value.shift() ?? fallback;
-}
-function resolveJsonResponseKey(options) {
-    const responseFormat = options.responseFormat;
-    if (!responseFormat || responseFormat.type !== "json") {
-        return "default";
-    }
-    const schema = responseFormat.schema;
-    const properties = schema?.properties ?? {};
-    if ("action" in properties && "twoStep" in properties) {
-        return "act";
-    }
-    if ("elements" in properties) {
-        return "Observation";
-    }
-    if ("completed" in properties && "progress" in properties) {
-        return "Metadata";
-    }
-    return "Extraction";
-}
-function promptToText(prompt) {
-    return (prompt ?? [])
-        .flatMap((message) => {
-        if (typeof message.content === "string") {
-            return [message.content];
-        }
-        return (message.content ?? [])
-            .map((part) => (part.type === "text" ? part.text : ""))
-            .filter((text) => text.length > 0);
-    })
-        .join("\n");
-}
-function findEncodedIds(options) {
-    return [...promptToText(options.prompt).matchAll(/\b\d+-\d+\b/g)].map((match) => match[0]);
-}
-function findEncodedIdForText(options, text) {
-    const promptText = promptToText(options.prompt);
-    const lines = promptText.split("\n");
-    const line = lines.find((entry) => entry.includes(text));
-    const match = line?.match(/\b\d+-\d+\b/);
-    if (!match) {
-        throw new Error(`Could not find encoded id for text: ${text}`);
-    }
-    return match[0];
-}
-function findLastEncodedId(options) {
-    const matches = findEncodedIds(options);
-    if (matches.length === 0) {
-        throw new Error("Could not find any encoded ids in the prompt.");
-    }
-    return matches[matches.length - 1];
-}
-function toolCallResponse(toolName, input, toolCallId = `${toolName}-1`) {
-    return {
-        content: [
-            {
-                type: "tool-call",
-                toolCallId,
-                toolName,
-                input: JSON.stringify(input),
-            },
-        ],
-        finishReason: "tool-calls",
-        usage: DEFAULT_USAGE,
-    };
-}
-function doneToolResponse(reasoning = "done", taskComplete = true, toolCallId = "done-1") {
-    return toolCallResponse("done", { reasoning, taskComplete }, toolCallId);
-}
-function createGenerateResult(result) {
-    return {
-        content: result.content,
-        finishReason: result.finishReason ?? "stop",
-        usage: mergeUsage(result.usage),
-        warnings: [],
-    };
-}
-function createScriptedAisdkTestLlmClient(options) {
-    const jsonResponses = Object.fromEntries(Object.entries(options?.jsonResponses ?? {}).map(([key, value]) => [
-        key,
-        Array.isArray(value) ? [...value] : value,
-    ]));
-    const generateResponses = [...(options?.generateResponses ?? [])];
-    const model = {
-        provider: "mock",
-        modelId: options?.modelId ?? "mock/stagehand-flow-logger",
-        specificationVersion: "v2",
-        supportedUrls: {},
-        doGenerateCalls: [],
-        doGenerate: async (callOptions) => {
-            model.doGenerateCalls.push(callOptions);
-            if (callOptions.responseFormat?.type === "json") {
-                const key = resolveJsonResponseKey(callOptions);
-                const responseScripts = consumeScriptValue(jsonResponses[key], jsonResponses.default);
-                const responseScript = consumeScriptValue(responseScripts, undefined);
-                const response = typeof responseScript === "function"
-                    ? responseScript(callOptions)
-                    : (responseScript ?? {});
-                return createGenerateResult({
-                    content: [{ type: "text", text: JSON.stringify(response) }],
-                });
-            }
-            const responseScript = consumeScriptValue(generateResponses, undefined);
-            if (!responseScript) {
-                return createGenerateResult({
-                    content: [{ type: "text", text: "done" }],
-                });
-            }
-            const response = typeof responseScript === "function"
-                ? responseScript(callOptions)
-                : responseScript;
-            return createGenerateResult(response);
-        },
-        doStream: async () => {
-            throw new Error("Streaming is not implemented for this test model.");
-        },
-    };
-    return new aisdk_js_1.AISdkClient({ model });
-}
-//# sourceMappingURL=testUtils.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"testUtils.js","sourceRoot":"","sources":["../../../../tests/integration/testUtils.ts"],"names":[],"mappings":"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","sourcesContent":["import type { V3 } from \"../../lib/v3/v3.js\";\nimport type {\n  LanguageModelV2,\n  LanguageModelV2CallOptions,\n  LanguageModelV2Content,\n  LanguageModelV2FinishReason,\n  LanguageModelV2Usage,\n} from \"@ai-sdk/provider\";\nimport { AISdkClient } from \"../../lib/v3/llm/aisdk.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\ntype JsonResponseKey =\n  | \"act\"\n  | \"Observation\"\n  | \"Metadata\"\n  | \"Extraction\"\n  | \"default\";\n\ntype JsonResponseValue =\n  | Record<string, unknown>\n  | ((options: LanguageModelV2CallOptions) => Record<string, unknown>);\n\ntype JsonResponseScript = JsonResponseValue | JsonResponseValue[];\n\ntype GenerateResponseValue =\n  | {\n      content: LanguageModelV2Content[];\n      finishReason?: LanguageModelV2FinishReason;\n      usage?: Partial<LanguageModelV2Usage>;\n    }\n  | ((options: LanguageModelV2CallOptions) => {\n      content: LanguageModelV2Content[];\n      finishReason?: LanguageModelV2FinishReason;\n      usage?: Partial<LanguageModelV2Usage>;\n    });\n\ntype ScriptedLanguageModel = LanguageModelV2 & {\n  doGenerateCalls: LanguageModelV2CallOptions[];\n};\n\ntype ScriptedGenerateResult = {\n  content: LanguageModelV2Content[];\n  finishReason?: LanguageModelV2FinishReason;\n  usage?: Partial<LanguageModelV2Usage>;\n};\n\nconst DEFAULT_USAGE: LanguageModelV2Usage = {\n  inputTokens: 1,\n  outputTokens: 1,\n  totalTokens: 2,\n  reasoningTokens: 0,\n  cachedInputTokens: 0,\n};\n\nconst mergeUsage = (\n  usage?: Partial<LanguageModelV2Usage>,\n): LanguageModelV2Usage => ({\n  ...DEFAULT_USAGE,\n  ...(usage ?? {}),\n});\n\nfunction consumeScriptValue<T>(value: T | T[] | undefined, fallback: T): T {\n  if (!Array.isArray(value)) {\n    return value ?? fallback;\n  }\n\n  if (value.length <= 1) {\n    return value[0] ?? fallback;\n  }\n\n  return value.shift() ?? fallback;\n}\n\nfunction resolveJsonResponseKey(\n  options: LanguageModelV2CallOptions,\n): JsonResponseKey {\n  const responseFormat = options.responseFormat;\n  if (!responseFormat || responseFormat.type !== \"json\") {\n    return \"default\";\n  }\n\n  const schema = responseFormat.schema as {\n    type?: string;\n    properties?: Record<string, unknown>;\n  };\n  const properties = schema?.properties ?? {};\n\n  if (\"action\" in properties && \"twoStep\" in properties) {\n    return \"act\";\n  }\n\n  if (\"elements\" in properties) {\n    return \"Observation\";\n  }\n\n  if (\"completed\" in properties && \"progress\" in properties) {\n    return \"Metadata\";\n  }\n\n  return \"Extraction\";\n}\n\nexport function promptToText(\n  prompt: LanguageModelV2CallOptions[\"prompt\"],\n): string {\n  return (prompt ?? [])\n    .flatMap((message) => {\n      if (typeof message.content === \"string\") {\n        return [message.content];\n      }\n\n      return (message.content ?? [])\n        .map((part) => (part.type === \"text\" ? part.text : \"\"))\n        .filter((text): text is string => text.length > 0);\n    })\n    .join(\"\\n\");\n}\n\nfunction findEncodedIds(options: LanguageModelV2CallOptions): string[] {\n  return [...promptToText(options.prompt).matchAll(/\\b\\d+-\\d+\\b/g)].map(\n    (match) => match[0],\n  );\n}\n\nexport function findEncodedIdForText(\n  options: LanguageModelV2CallOptions,\n  text: string,\n): string {\n  const promptText = promptToText(options.prompt);\n  const lines = promptText.split(\"\\n\");\n  const line = lines.find((entry) => entry.includes(text));\n  const match = line?.match(/\\b\\d+-\\d+\\b/);\n\n  if (!match) {\n    throw new Error(`Could not find encoded id for text: ${text}`);\n  }\n\n  return match[0];\n}\n\nexport function findLastEncodedId(options: LanguageModelV2CallOptions): string {\n  const matches = findEncodedIds(options);\n  if (matches.length === 0) {\n    throw new Error(\"Could not find any encoded ids in the prompt.\");\n  }\n\n  return matches[matches.length - 1];\n}\n\nexport function toolCallResponse(\n  toolName: string,\n  input: Record<string, unknown>,\n  toolCallId = `${toolName}-1`,\n): {\n  content: LanguageModelV2Content[];\n  finishReason: LanguageModelV2FinishReason;\n  usage: LanguageModelV2Usage;\n} {\n  return {\n    content: [\n      {\n        type: \"tool-call\",\n        toolCallId,\n        toolName,\n        input: JSON.stringify(input),\n      },\n    ],\n    finishReason: \"tool-calls\",\n    usage: DEFAULT_USAGE,\n  };\n}\n\nexport function doneToolResponse(\n  reasoning = \"done\",\n  taskComplete = true,\n  toolCallId = \"done-1\",\n): {\n  content: LanguageModelV2Content[];\n  finishReason: LanguageModelV2FinishReason;\n  usage: LanguageModelV2Usage;\n} {\n  return toolCallResponse(\"done\", { reasoning, taskComplete }, toolCallId);\n}\n\nfunction createGenerateResult(result: ScriptedGenerateResult): {\n  content: LanguageModelV2Content[];\n  finishReason: LanguageModelV2FinishReason;\n  usage: LanguageModelV2Usage;\n  warnings: [];\n} {\n  return {\n    content: result.content,\n    finishReason: result.finishReason ?? \"stop\",\n    usage: mergeUsage(result.usage),\n    warnings: [],\n  };\n}\n\nexport function createScriptedAisdkTestLlmClient(options?: {\n  modelId?: string;\n  jsonResponses?: Partial<Record<JsonResponseKey, JsonResponseScript>>;\n  generateResponses?: GenerateResponseValue[];\n}): AISdkClient {\n  const jsonResponses = Object.fromEntries(\n    Object.entries(options?.jsonResponses ?? {}).map(([key, value]) => [\n      key,\n      Array.isArray(value) ? [...value] : value,\n    ]),\n  ) as Partial<Record<JsonResponseKey, JsonResponseScript>>;\n  const generateResponses = [...(options?.generateResponses ?? [])];\n\n  const model: ScriptedLanguageModel = {\n    provider: \"mock\",\n    modelId: options?.modelId ?? \"mock/stagehand-flow-logger\",\n    specificationVersion: \"v2\",\n    supportedUrls: {},\n    doGenerateCalls: [],\n    doGenerate: async (callOptions) => {\n      model.doGenerateCalls.push(callOptions);\n\n      if (callOptions.responseFormat?.type === \"json\") {\n        const key = resolveJsonResponseKey(callOptions);\n        const responseScripts = consumeScriptValue<\n          JsonResponseScript | undefined\n        >(jsonResponses[key], jsonResponses.default);\n        const responseScript = consumeScriptValue<\n          JsonResponseValue | undefined\n        >(responseScripts, undefined);\n        const response =\n          typeof responseScript === \"function\"\n            ? responseScript(callOptions)\n            : (responseScript ?? {});\n\n        return createGenerateResult({\n          content: [{ type: \"text\", text: JSON.stringify(response) }],\n        });\n      }\n\n      const responseScript = consumeScriptValue<\n        GenerateResponseValue | undefined\n      >(generateResponses, undefined);\n\n      if (!responseScript) {\n        return createGenerateResult({\n          content: [{ type: \"text\", text: \"done\" }],\n        });\n      }\n\n      const response =\n        typeof responseScript === \"function\"\n          ? responseScript(callOptions)\n          : responseScript;\n\n      return createGenerateResult(response);\n    },\n    doStream: async () => {\n      throw new Error(\"Streaming is not implemented for this test model.\");\n    },\n  };\n\n  return new AISdkClient({ model });\n}\n"]}

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

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

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

@@ -1,105 +0,0 @@
-"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

@@ -1 +0,0 @@
-{"version":3,"file":"text-selector-innermost.spec.js","sourceRoot":"","sources":["../../../../tests/integration/text-selector-innermost.spec.ts"],"names":[],"mappings":"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","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

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