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

package/dist/cjs/tests/unit/snapshot-xpath-utils.test.js

@@ -0,0 +1,74 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const xpathUtils_js_1 = require("../../lib/v3/understudy/a11y/snapshot/xpathUtils.js");
+const domTree_js_1 = require("../../lib/v3/understudy/a11y/snapshot/domTree.js");
+(0, vitest_1.describe)("prefixXPath", () => {
+    (0, vitest_1.it)("treats root prefixes as no-op", () => {
+        (0, vitest_1.expect)((0, xpathUtils_js_1.prefixXPath)("/", "/div[1]")).toBe("/div[1]");
+        (0, vitest_1.expect)((0, xpathUtils_js_1.prefixXPath)("/", "//div[1]")).toBe("//div[1]");
+    });
+    (0, vitest_1.it)("handles descendant hops and blank children", () => {
+        (0, vitest_1.expect)((0, xpathUtils_js_1.prefixXPath)("/html/body", "//slot[1]")).toBe("/html/body//slot[1]");
+        (0, vitest_1.expect)((0, xpathUtils_js_1.prefixXPath)("/html/body", "/")).toBe("/html/body");
+        (0, vitest_1.expect)((0, xpathUtils_js_1.prefixXPath)("/html/body/", "")).toBe("/html/body");
+    });
+});
+(0, vitest_1.describe)("normalizeXPath", () => {
+    (0, vitest_1.it)("strips prefixes, trims whitespace, and enforces absolute roots", () => {
+        (0, vitest_1.expect)((0, xpathUtils_js_1.normalizeXPath)("   xpath=/html/body/ ")).toBe("/html/body");
+        (0, vitest_1.expect)((0, xpathUtils_js_1.normalizeXPath)("div/span")).toBe("/div/span");
+        (0, vitest_1.expect)((0, xpathUtils_js_1.normalizeXPath)("")).toBe("");
+        (0, vitest_1.expect)((0, xpathUtils_js_1.normalizeXPath)()).toBe("");
+    });
+});
+(0, vitest_1.describe)("relativizeXPath", () => {
+    (0, vitest_1.it)("returns '/' when paths match exactly", () => {
+        (0, vitest_1.expect)((0, domTree_js_1.relativizeXPath)("/html/body", "/html/body")).toBe("/");
+    });
+    (0, vitest_1.it)("omits duplicate prefixes and preserves descendant hops", () => {
+        (0, vitest_1.expect)((0, domTree_js_1.relativizeXPath)("/html/body", "/html/body/div[2]")).toBe("/div[2]");
+        (0, vitest_1.expect)((0, domTree_js_1.relativizeXPath)("/html/body", "/html/body//shadow-root[1]")).toBe("//shadow-root[1]");
+    });
+    (0, vitest_1.it)("falls back to absolute paths outside of the base document", () => {
+        (0, vitest_1.expect)((0, domTree_js_1.relativizeXPath)("/html/body", "/head")).toBe("/head");
+        (0, vitest_1.expect)((0, domTree_js_1.relativizeXPath)("/", "/html/body")).toBe("/html/body");
+    });
+});
+(0, vitest_1.describe)("buildChildXPathSegments", () => {
+    (0, vitest_1.it)("produces positional selectors for each node type", () => {
+        const makeNode = (nodeType, nodeName, override) => ({
+            nodeId: 1,
+            backendNodeId: 1,
+            localName: nodeName.toLowerCase(),
+            nodeValue: "",
+            ...override,
+            nodeType,
+            nodeName,
+        });
+        const nodes = [
+            makeNode(1, "DIV"),
+            makeNode(1, "DIV"),
+            makeNode(1, "svg:path"),
+            makeNode(3, "#text"),
+            makeNode(8, "#comment"),
+        ];
+        (0, vitest_1.expect)((0, xpathUtils_js_1.buildChildXPathSegments)(nodes)).toEqual([
+            "div[1]",
+            "div[2]",
+            "*[name()='svg:path'][1]",
+            "text()[1]",
+            "comment()[1]",
+        ]);
+    });
+});
+(0, vitest_1.describe)("joinXPath", () => {
+    (0, vitest_1.it)("joins base and steps while preserving special hops", () => {
+        (0, vitest_1.expect)((0, xpathUtils_js_1.joinXPath)("", "div[1]")).toBe("/div[1]");
+        (0, vitest_1.expect)((0, xpathUtils_js_1.joinXPath)("/", "span[1]")).toBe("/span[1]");
+        (0, vitest_1.expect)((0, xpathUtils_js_1.joinXPath)("/html/body", "//")).toBe("/html/body//");
+        (0, vitest_1.expect)((0, xpathUtils_js_1.joinXPath)("/html//", "slot[1]")).toBe("/html//slot[1]");
+        (0, vitest_1.expect)((0, xpathUtils_js_1.joinXPath)("/html/body", "")).toBe("/html/body");
+    });
+});
+//# sourceMappingURL=snapshot-xpath-utils.test.js.map

package/dist/cjs/tests/unit/snapshot-xpath-utils.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-xpath-utils.test.js","sourceRoot":"","sources":["../../../../tests/unit/snapshot-xpath-utils.test.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Protocol } from \"devtools-protocol\";\nimport { describe, expect, it } from \"vitest\";\nimport {\n  buildChildXPathSegments,\n  joinXPath,\n  normalizeXPath,\n  prefixXPath,\n} from \"../../lib/v3/understudy/a11y/snapshot/xpathUtils.js\";\nimport { relativizeXPath } from \"../../lib/v3/understudy/a11y/snapshot/domTree.js\";\n\ndescribe(\"prefixXPath\", () => {\n  it(\"treats root prefixes as no-op\", () => {\n    expect(prefixXPath(\"/\", \"/div[1]\")).toBe(\"/div[1]\");\n    expect(prefixXPath(\"/\", \"//div[1]\")).toBe(\"//div[1]\");\n  });\n\n  it(\"handles descendant hops and blank children\", () => {\n    expect(prefixXPath(\"/html/body\", \"//slot[1]\")).toBe(\"/html/body//slot[1]\");\n    expect(prefixXPath(\"/html/body\", \"/\")).toBe(\"/html/body\");\n    expect(prefixXPath(\"/html/body/\", \"\")).toBe(\"/html/body\");\n  });\n});\n\ndescribe(\"normalizeXPath\", () => {\n  it(\"strips prefixes, trims whitespace, and enforces absolute roots\", () => {\n    expect(normalizeXPath(\"   xpath=/html/body/ \")).toBe(\"/html/body\");\n    expect(normalizeXPath(\"div/span\")).toBe(\"/div/span\");\n    expect(normalizeXPath(\"\")).toBe(\"\");\n    expect(normalizeXPath()).toBe(\"\");\n  });\n});\n\ndescribe(\"relativizeXPath\", () => {\n  it(\"returns '/' when paths match exactly\", () => {\n    expect(relativizeXPath(\"/html/body\", \"/html/body\")).toBe(\"/\");\n  });\n\n  it(\"omits duplicate prefixes and preserves descendant hops\", () => {\n    expect(relativizeXPath(\"/html/body\", \"/html/body/div[2]\")).toBe(\"/div[2]\");\n    expect(relativizeXPath(\"/html/body\", \"/html/body//shadow-root[1]\")).toBe(\n      \"//shadow-root[1]\",\n    );\n  });\n\n  it(\"falls back to absolute paths outside of the base document\", () => {\n    expect(relativizeXPath(\"/html/body\", \"/head\")).toBe(\"/head\");\n    expect(relativizeXPath(\"/\", \"/html/body\")).toBe(\"/html/body\");\n  });\n});\n\ndescribe(\"buildChildXPathSegments\", () => {\n  it(\"produces positional selectors for each node type\", () => {\n    const makeNode = (\n      nodeType: number,\n      nodeName: string,\n      override?: Partial<Protocol.DOM.Node>,\n    ): Protocol.DOM.Node => ({\n      nodeId: 1,\n      backendNodeId: 1,\n      localName: nodeName.toLowerCase(),\n      nodeValue: \"\",\n      ...override,\n      nodeType,\n      nodeName,\n    });\n\n    const nodes: Protocol.DOM.Node[] = [\n      makeNode(1, \"DIV\"),\n      makeNode(1, \"DIV\"),\n      makeNode(1, \"svg:path\"),\n      makeNode(3, \"#text\"),\n      makeNode(8, \"#comment\"),\n    ];\n\n    expect(buildChildXPathSegments(nodes)).toEqual([\n      \"div[1]\",\n      \"div[2]\",\n      \"*[name()='svg:path'][1]\",\n      \"text()[1]\",\n      \"comment()[1]\",\n    ]);\n  });\n});\n\ndescribe(\"joinXPath\", () => {\n  it(\"joins base and steps while preserving special hops\", () => {\n    expect(joinXPath(\"\", \"div[1]\")).toBe(\"/div[1]\");\n    expect(joinXPath(\"/\", \"span[1]\")).toBe(\"/span[1]\");\n    expect(joinXPath(\"/html/body\", \"//\")).toBe(\"/html/body//\");\n    expect(joinXPath(\"/html//\", \"slot[1]\")).toBe(\"/html//slot[1]\");\n    expect(joinXPath(\"/html/body\", \"\")).toBe(\"/html/body\");\n  });\n});\n"]}

package/dist/cjs/tests/unit/timeout-handlers.test.d.ts

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