@browserbasehq/orca 3.1.0-patch.3 → 3.2.0-preview.1

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

@@ -0,0 +1,72 @@
+import { describe, expect, it } from "vitest";
+import { buildChildXPathSegments, joinXPath, normalizeXPath, prefixXPath, } from "../../lib/v3/understudy/a11y/snapshot/xpathUtils.js";
+import { relativizeXPath } from "../../lib/v3/understudy/a11y/snapshot/domTree.js";
+describe("prefixXPath", () => {
+    it("treats root prefixes as no-op", () => {
+        expect(prefixXPath("/", "/div[1]")).toBe("/div[1]");
+        expect(prefixXPath("/", "//div[1]")).toBe("//div[1]");
+    });
+    it("handles descendant hops and blank children", () => {
+        expect(prefixXPath("/html/body", "//slot[1]")).toBe("/html/body//slot[1]");
+        expect(prefixXPath("/html/body", "/")).toBe("/html/body");
+        expect(prefixXPath("/html/body/", "")).toBe("/html/body");
+    });
+});
+describe("normalizeXPath", () => {
+    it("strips prefixes, trims whitespace, and enforces absolute roots", () => {
+        expect(normalizeXPath("   xpath=/html/body/ ")).toBe("/html/body");
+        expect(normalizeXPath("div/span")).toBe("/div/span");
+        expect(normalizeXPath("")).toBe("");
+        expect(normalizeXPath()).toBe("");
+    });
+});
+describe("relativizeXPath", () => {
+    it("returns '/' when paths match exactly", () => {
+        expect(relativizeXPath("/html/body", "/html/body")).toBe("/");
+    });
+    it("omits duplicate prefixes and preserves descendant hops", () => {
+        expect(relativizeXPath("/html/body", "/html/body/div[2]")).toBe("/div[2]");
+        expect(relativizeXPath("/html/body", "/html/body//shadow-root[1]")).toBe("//shadow-root[1]");
+    });
+    it("falls back to absolute paths outside of the base document", () => {
+        expect(relativizeXPath("/html/body", "/head")).toBe("/head");
+        expect(relativizeXPath("/", "/html/body")).toBe("/html/body");
+    });
+});
+describe("buildChildXPathSegments", () => {
+    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"),
+        ];
+        expect(buildChildXPathSegments(nodes)).toEqual([
+            "div[1]",
+            "div[2]",
+            "*[name()='svg:path'][1]",
+            "text()[1]",
+            "comment()[1]",
+        ]);
+    });
+});
+describe("joinXPath", () => {
+    it("joins base and steps while preserving special hops", () => {
+        expect(joinXPath("", "div[1]")).toBe("/div[1]");
+        expect(joinXPath("/", "span[1]")).toBe("/span[1]");
+        expect(joinXPath("/html/body", "//")).toBe("/html/body//");
+        expect(joinXPath("/html//", "slot[1]")).toBe("/html//slot[1]");
+        expect(joinXPath("/html/body", "")).toBe("/html/body");
+    });
+});
+//# sourceMappingURL=snapshot-xpath-utils.test.js.map

package/dist/esm/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/esm/tests/unit/timeout-handlers.test.d.ts

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