npm - @browserbasehq/orca - Versions diffs - 3.0.9-alpha-4 → 3.1.0-patch.1 - Mend

@browserbasehq/orca 3.0.9-alpha-4 → 3.1.0-patch.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (990) hide show

package/dist/esm/lib/v3/tests/page-scroll.spec.js ADDED Viewed

@@ -0,0 +1,182 @@
+import { test, expect } from "@playwright/test";
+import { V3 } from "../v3.js";
+import { v3TestConfig } from "./v3.config.js";
+test.describe("Page.scroll() - mouse wheel scrolling", () => {
+  let v3;
+  test.beforeEach(async () => {
+    v3 = new V3(v3TestConfig);
+    await v3.init();
+  });
+  test.afterEach(async () => {
+    await v3?.close?.().catch(() => {
+    });
+  });
+  test("scrolls page vertically with positive deltaY", async () => {
+    const page = v3.context.pages()[0];
+    await page.goto(
+      "data:text/html," + encodeURIComponent(
+        `<!doctype html><html><body style="height: 2000px;">
+            <div style="height: 400px; background: lightblue;">Section 1</div>
+            <div style="height: 400px; background: lightgreen;">Section 2</div>
+            <div style="height: 400px; background: lightyellow;">Section 3</div>
+            <div style="height: 400px; background: lightcoral;">Section 4</div>
+            <div style="height: 400px; background: lightgray;">Section 5</div>
+          </body></html>`
+      )
+    );
+    let scrollY = await page.evaluate(() => window.scrollY);
+    expect(scrollY).toBe(0);
+    await page.scroll(640, 400, 0, 300);
+    await page.evaluate(() => new Promise((r) => setTimeout(r, 200)));
+    scrollY = await page.evaluate(() => window.scrollY);
+    expect(scrollY).toBeGreaterThan(0);
+  });
+  test("scrolls page horizontally with positive deltaX", async () => {
+    const page = v3.context.pages()[0];
+    await page.goto(
+      "data:text/html," + encodeURIComponent(
+        `<!doctype html><html><body style="width: 2000px; height: 600px;">
+            <div style="display: inline-block; width: 400px; height: 100%; background: lightblue;">Section 1</div>
+            <div style="display: inline-block; width: 400px; height: 100%; background: lightgreen;">Section 2</div>
+            <div style="display: inline-block; width: 400px; height: 100%; background: lightyellow;">Section 3</div>
+            <div style="display: inline-block; width: 400px; height: 100%; background: lightcoral;">Section 4</div>
+            <div style="display: inline-block; width: 400px; height: 100%; background: lightgray;">Section 5</div>
+          </body></html>`
+      )
+    );
+    let scrollX = await page.evaluate(() => window.scrollX);
+    expect(scrollX).toBe(0);
+    await page.scroll(640, 400, 300, 0);
+    await page.evaluate(() => new Promise((r) => setTimeout(r, 200)));
+    scrollX = await page.evaluate(() => window.scrollX);
+    expect(scrollX).toBeGreaterThan(0);
+  });
+  test("scrolls in both directions simultaneously", async () => {
+    const page = v3.context.pages()[0];
+    await page.goto(
+      "data:text/html," + encodeURIComponent(
+        `<!doctype html><html><body style="width: 2000px; height: 2000px;">
+            <div style="width: 100%; height: 100%; background: linear-gradient(135deg, lightblue, lightcoral);">
+              Diagonal content
+            </div>
+          </body></html>`
+      )
+    );
+    await page.scroll(640, 400, 200, 200);
+    await page.evaluate(() => new Promise((r) => setTimeout(r, 200)));
+    const scrollPos = await page.evaluate(() => ({
+      x: window.scrollX,
+      y: window.scrollY
+    }));
+    expect(scrollPos.x).toBeGreaterThan(0);
+    expect(scrollPos.y).toBeGreaterThan(0);
+  });
+  test("scrolls at specific coordinate on page", async () => {
+    const page = v3.context.pages()[0];
+    await page.goto(
+      "data:text/html," + encodeURIComponent(
+        `<!doctype html><html><body style="height: 2000px;">
+            <div id="marker" style="position: fixed; top: 400px; left: 640px; width: 2px; height: 2px; background: red;"></div>
+            <div style="height: 500px; background: lightblue;">Top</div>
+            <div style="height: 500px; background: lightgreen;">Middle</div>
+            <div style="height: 500px; background: lightyellow;">Bottom</div>
+          </body></html>`
+      )
+    );
+    await page.scroll(640, 400, 0, 400);
+    await page.evaluate(() => new Promise((r) => setTimeout(r, 200)));
+    const scrollY = await page.evaluate(() => window.scrollY);
+    expect(scrollY).toBeGreaterThan(0);
+  });
+  test("scrolls with large deltaY values", async () => {
+    const page = v3.context.pages()[0];
+    await page.goto(
+      "data:text/html," + encodeURIComponent(
+        `<!doctype html><html><body style="height: 5000px;">
+            <div style="height: 1000px; background: lightblue;">Section 1</div>
+            <div style="height: 1000px; background: lightgreen;">Section 2</div>
+            <div style="height: 1000px; background: lightyellow;">Section 3</div>
+            <div style="height: 1000px; background: lightcoral;">Section 4</div>
+            <div style="height: 1000px; background: lightgray;">Section 5</div>
+          </body></html>`
+      )
+    );
+    await page.scroll(640, 400, 0, 1e3);
+    await page.evaluate(() => new Promise((r) => setTimeout(r, 200)));
+    const scrollY = await page.evaluate(() => window.scrollY);
+    expect(scrollY).toBeGreaterThan(500);
+  });
+  test("negative deltaY scrolls up", async () => {
+    const page = v3.context.pages()[0];
+    await page.goto(
+      "data:text/html," + encodeURIComponent(
+        `<!doctype html><html><body style="height: 2000px;">
+            <div style="height: 500px; background: lightblue;">Top</div>
+            <div style="height: 500px; background: lightgreen;">Middle 1</div>
+            <div style="height: 500px; background: lightyellow;">Middle 2</div>
+            <div style="height: 500px; background: lightcoral;">Bottom</div>
+          </body></html>`
+      )
+    );
+    await page.scroll(640, 400, 0, 500);
+    await page.evaluate(() => new Promise((r) => setTimeout(r, 200)));
+    let scrollY = await page.evaluate(() => window.scrollY);
+    const scrolledDown = scrollY;
+    expect(scrolledDown).toBeGreaterThan(0);
+    await page.scroll(640, 400, 0, -300);
+    await page.evaluate(() => new Promise((r) => setTimeout(r, 200)));
+    scrollY = await page.evaluate(() => window.scrollY);
+    expect(scrollY).toBeLessThan(scrolledDown);
+  });
+  test("scroll returns xpath when requested", async () => {
+    const page = v3.context.pages()[0];
+    await page.goto(
+      "data:text/html," + encodeURIComponent(
+        `<!doctype html><html><body style="height: 2000px; margin: 0; padding: 0;">
+            <div id="target" style="position: absolute; top: 0px; left: 400px; width: 300px; height: 100px; background: blue;">
+              Target element
+            </div>
+            <p style="position: absolute; top: 200px; left: 0px;">Content below</p>
+          </body></html>`
+      )
+    );
+    const xpath = await page.scroll(550, 50, 0, 200, { returnXpath: true });
+    expect(typeof xpath).toBe("string");
+    expect(xpath.length).toBeGreaterThan(0);
+    expect(xpath.toLowerCase()).toMatch(/div|target/);
+  });
+  test("scroll without returnXpath returns empty string", async () => {
+    const page = v3.context.pages()[0];
+    await page.goto(
+      "data:text/html," + encodeURIComponent(
+        `<!doctype html><html><body style="height: 2000px;">
+            <div style="height: 500px; background: lightblue;">Content</div>
+          </body></html>`
+      )
+    );
+    const result = await page.scroll(640, 400, 0, 200);
+    expect(result).toBe("");
+  });
+  test("multiple sequential scrolls accumulate", async () => {
+    const page = v3.context.pages()[0];
+    await page.goto(
+      "data:text/html," + encodeURIComponent(
+        `<!doctype html><html><body style="height: 3000px;">
+            <div style="height: 750px; background: lightblue;">Section 1</div>
+            <div style="height: 750px; background: lightgreen;">Section 2</div>
+            <div style="height: 750px; background: lightyellow;">Section 3</div>
+            <div style="height: 750px; background: lightcoral;">Section 4</div>
+          </body></html>`
+      )
+    );
+    await page.scroll(640, 400, 0, 200);
+    await page.evaluate(() => new Promise((r) => setTimeout(r, 200)));
+    const after1 = await page.evaluate(() => window.scrollY);
+    expect(after1).toBeGreaterThan(0);
+    await page.scroll(640, 400, 0, 200);
+    await page.evaluate(() => new Promise((r) => setTimeout(r, 200)));
+    const after2 = await page.evaluate(() => window.scrollY);
+    expect(after2).toBeGreaterThan(after1);
+  });
+});
+//# sourceMappingURL=page-scroll.spec.js.map

package/dist/esm/lib/v3/tests/page-scroll.spec.js.map ADDED Viewed

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../lib/v3/tests/page-scroll.spec.ts"],
+  "sourcesContent": ["import { test, expect } from \"@playwright/test\";\nimport { V3 } from \"../v3.js\";\nimport { v3TestConfig } from \"./v3.config.js\";\n\ntest.describe(\"Page.scroll() - mouse wheel scrolling\", () => {\n  let v3: V3;\n\n  test.beforeEach(async () => {\n    v3 = new V3(v3TestConfig);\n    await v3.init();\n  });\n\n  test.afterEach(async () => {\n    await v3?.close?.().catch(() => {});\n  });\n\n  test(\"scrolls page vertically with positive deltaY\", async () => {\n    const page = v3.context.pages()[0];\n\n    await page.goto(\n      \"data:text/html,\" +\n        encodeURIComponent(\n          `<!doctype html><html><body style=\"height: 2000px;\">\n            <div style=\"height: 400px; background: lightblue;\">Section 1</div>\n            <div style=\"height: 400px; background: lightgreen;\">Section 2</div>\n            <div style=\"height: 400px; background: lightyellow;\">Section 3</div>\n            <div style=\"height: 400px; background: lightcoral;\">Section 4</div>\n            <div style=\"height: 400px; background: lightgray;\">Section 5</div>\n          </body></html>`,\n        ),\n    );\n\n    // Get initial scroll position\n    let scrollY = await page.evaluate(() => window.scrollY);\n    expect(scrollY).toBe(0);\n\n    // Scroll down (positive deltaY)\n    await page.scroll(640, 400, 0, 300);\n\n    // Wait for scroll to complete\n    await page.evaluate(() => new Promise((r) => setTimeout(r, 200)));\n\n    // Check that we've scrolled down\n    scrollY = await page.evaluate(() => window.scrollY);\n    expect(scrollY).toBeGreaterThan(0);\n  });\n\n  test(\"scrolls page horizontally with positive deltaX\", async () => {\n    const page = v3.context.pages()[0];\n\n    await page.goto(\n      \"data:text/html,\" +\n        encodeURIComponent(\n          `<!doctype html><html><body style=\"width: 2000px; height: 600px;\">\n            <div style=\"display: inline-block; width: 400px; height: 100%; background: lightblue;\">Section 1</div>\n            <div style=\"display: inline-block; width: 400px; height: 100%; background: lightgreen;\">Section 2</div>\n            <div style=\"display: inline-block; width: 400px; height: 100%; background: lightyellow;\">Section 3</div>\n            <div style=\"display: inline-block; width: 400px; height: 100%; background: lightcoral;\">Section 4</div>\n            <div style=\"display: inline-block; width: 400px; height: 100%; background: lightgray;\">Section 5</div>\n          </body></html>`,\n        ),\n    );\n\n    let scrollX = await page.evaluate(() => window.scrollX);\n    expect(scrollX).toBe(0);\n\n    // Scroll right (positive deltaX)\n    await page.scroll(640, 400, 300, 0);\n\n    // Wait for scroll to complete\n    await page.evaluate(() => new Promise((r) => setTimeout(r, 200)));\n\n    // Check that we've scrolled right\n    scrollX = await page.evaluate(() => window.scrollX);\n    expect(scrollX).toBeGreaterThan(0);\n  });\n\n  test(\"scrolls in both directions simultaneously\", async () => {\n    const page = v3.context.pages()[0];\n\n    await page.goto(\n      \"data:text/html,\" +\n        encodeURIComponent(\n          `<!doctype html><html><body style=\"width: 2000px; height: 2000px;\">\n            <div style=\"width: 100%; height: 100%; background: linear-gradient(135deg, lightblue, lightcoral);\">\n              Diagonal content\n            </div>\n          </body></html>`,\n        ),\n    );\n\n    // Scroll both horizontally and vertically\n    await page.scroll(640, 400, 200, 200);\n\n    // Wait for scroll to complete\n    await page.evaluate(() => new Promise((r) => setTimeout(r, 200)));\n\n    // Check both directions changed\n    const scrollPos = await page.evaluate(() => ({\n      x: window.scrollX,\n      y: window.scrollY,\n    }));\n\n    expect(scrollPos.x).toBeGreaterThan(0);\n    expect(scrollPos.y).toBeGreaterThan(0);\n  });\n\n  test(\"scrolls at specific coordinate on page\", async () => {\n    const page = v3.context.pages()[0];\n\n    await page.goto(\n      \"data:text/html,\" +\n        encodeURIComponent(\n          `<!doctype html><html><body style=\"height: 2000px;\">\n            <div id=\"marker\" style=\"position: fixed; top: 400px; left: 640px; width: 2px; height: 2px; background: red;\"></div>\n            <div style=\"height: 500px; background: lightblue;\">Top</div>\n            <div style=\"height: 500px; background: lightgreen;\">Middle</div>\n            <div style=\"height: 500px; background: lightyellow;\">Bottom</div>\n          </body></html>`,\n        ),\n    );\n\n    // Scroll from specific coordinates\n    await page.scroll(640, 400, 0, 400);\n\n    // Wait for scroll to complete\n    await page.evaluate(() => new Promise((r) => setTimeout(r, 200)));\n\n    // Verify scroll happened\n    const scrollY = await page.evaluate(() => window.scrollY);\n    expect(scrollY).toBeGreaterThan(0);\n  });\n\n  test(\"scrolls with large deltaY values\", async () => {\n    const page = v3.context.pages()[0];\n\n    await page.goto(\n      \"data:text/html,\" +\n        encodeURIComponent(\n          `<!doctype html><html><body style=\"height: 5000px;\">\n            <div style=\"height: 1000px; background: lightblue;\">Section 1</div>\n            <div style=\"height: 1000px; background: lightgreen;\">Section 2</div>\n            <div style=\"height: 1000px; background: lightyellow;\">Section 3</div>\n            <div style=\"height: 1000px; background: lightcoral;\">Section 4</div>\n            <div style=\"height: 1000px; background: lightgray;\">Section 5</div>\n          </body></html>`,\n        ),\n    );\n\n    // Scroll with large delta\n    await page.scroll(640, 400, 0, 1000);\n\n    // Wait for scroll to complete\n    await page.evaluate(() => new Promise((r) => setTimeout(r, 200)));\n\n    // Should scroll significantly\n    const scrollY = await page.evaluate(() => window.scrollY);\n    expect(scrollY).toBeGreaterThan(500);\n  });\n\n  test(\"negative deltaY scrolls up\", async () => {\n    const page = v3.context.pages()[0];\n\n    await page.goto(\n      \"data:text/html,\" +\n        encodeURIComponent(\n          `<!doctype html><html><body style=\"height: 2000px;\">\n            <div style=\"height: 500px; background: lightblue;\">Top</div>\n            <div style=\"height: 500px; background: lightgreen;\">Middle 1</div>\n            <div style=\"height: 500px; background: lightyellow;\">Middle 2</div>\n            <div style=\"height: 500px; background: lightcoral;\">Bottom</div>\n          </body></html>`,\n        ),\n    );\n\n    // First scroll down\n    await page.scroll(640, 400, 0, 500);\n    await page.evaluate(() => new Promise((r) => setTimeout(r, 200)));\n\n    let scrollY = await page.evaluate(() => window.scrollY);\n    const scrolledDown = scrollY;\n    expect(scrolledDown).toBeGreaterThan(0);\n\n    // Now scroll up (negative delta)\n    await page.scroll(640, 400, 0, -300);\n    await page.evaluate(() => new Promise((r) => setTimeout(r, 200)));\n\n    scrollY = await page.evaluate(() => window.scrollY);\n    expect(scrollY).toBeLessThan(scrolledDown);\n  });\n\n  test(\"scroll returns xpath when requested\", async () => {\n    const page = v3.context.pages()[0];\n\n    await page.goto(\n      \"data:text/html,\" +\n        encodeURIComponent(\n          `<!doctype html><html><body style=\"height: 2000px; margin: 0; padding: 0;\">\n            <div id=\"target\" style=\"position: absolute; top: 0px; left: 400px; width: 300px; height: 100px; background: blue;\">\n              Target element\n            </div>\n            <p style=\"position: absolute; top: 200px; left: 0px;\">Content below</p>\n          </body></html>`,\n        ),\n    );\n\n    // Scroll at coordinate (550, 50) which should be directly over the target div\n    // div spans: left 400-700px, top 0-100px\n    // coordinate 550,50 is within that range\n    const xpath = await page.scroll(550, 50, 0, 200, { returnXpath: true });\n\n    // Should return a non-empty xpath string for the element at that coordinate\n    expect(typeof xpath).toBe(\"string\");\n    expect(xpath.length).toBeGreaterThan(0);\n    // Xpath should reference the div or contain \"target\"\n    expect(xpath.toLowerCase()).toMatch(/div|target/);\n  });\n\n  test(\"scroll without returnXpath returns empty string\", async () => {\n    const page = v3.context.pages()[0];\n\n    await page.goto(\n      \"data:text/html,\" +\n        encodeURIComponent(\n          `<!doctype html><html><body style=\"height: 2000px;\">\n            <div style=\"height: 500px; background: lightblue;\">Content</div>\n          </body></html>`,\n        ),\n    );\n\n    // Scroll without returnXpath\n    const result = await page.scroll(640, 400, 0, 200);\n\n    // Should return empty string\n    expect(result).toBe(\"\");\n  });\n\n  test(\"multiple sequential scrolls accumulate\", async () => {\n    const page = v3.context.pages()[0];\n\n    await page.goto(\n      \"data:text/html,\" +\n        encodeURIComponent(\n          `<!doctype html><html><body style=\"height: 3000px;\">\n            <div style=\"height: 750px; background: lightblue;\">Section 1</div>\n            <div style=\"height: 750px; background: lightgreen;\">Section 2</div>\n            <div style=\"height: 750px; background: lightyellow;\">Section 3</div>\n            <div style=\"height: 750px; background: lightcoral;\">Section 4</div>\n          </body></html>`,\n        ),\n    );\n\n    // First scroll\n    await page.scroll(640, 400, 0, 200);\n    await page.evaluate(() => new Promise((r) => setTimeout(r, 200)));\n\n    const after1 = await page.evaluate(() => window.scrollY);\n    expect(after1).toBeGreaterThan(0);\n\n    // Second scroll\n    await page.scroll(640, 400, 0, 200);\n    await page.evaluate(() => new Promise((r) => setTimeout(r, 200)));\n\n    const after2 = await page.evaluate(() => window.scrollY);\n\n    expect(after2).toBeGreaterThan(after1);\n  });\n});\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/esm/lib/v3/tests/page-send-cdp.spec.js ADDED Viewed

@@ -0,0 +1,46 @@
+import { test, expect } from "@playwright/test";
+import { V3 } from "../v3.js";
+import { v3TestConfig } from "./v3.config.js";
+test.describe("Page sendCDP method", () => {
+  let v3;
+  test.beforeEach(async () => {
+    v3 = new V3(v3TestConfig);
+    await v3.init();
+  });
+  test.afterEach(async () => {
+    await v3?.close?.().catch(() => {
+    });
+  });
+  test("sends CDP commands and requires domain to be enabled first", async () => {
+    const page = v3.context.pages()[0];
+    await page.goto("https://example.com");
+    await expect(
+      page.sendCDP("WebAuthn.addVirtualAuthenticator", {
+        options: {
+          protocol: "ctap2",
+          transport: "usb",
+          hasResidentKey: false,
+          hasUserVerification: false,
+          isUserVerified: false
+        }
+      })
+    ).rejects.toThrow();
+    await page.sendCDP("WebAuthn.enable");
+    const result = await page.sendCDP(
+      "WebAuthn.addVirtualAuthenticator",
+      {
+        options: {
+          protocol: "ctap2",
+          transport: "usb",
+          hasResidentKey: false,
+          hasUserVerification: false,
+          isUserVerified: false
+        }
+      }
+    );
+    expect(result).toHaveProperty("authenticatorId");
+    expect(typeof result.authenticatorId).toBe("string");
+    expect(result.authenticatorId.length).toBeGreaterThan(0);
+  });
+});
+//# sourceMappingURL=page-send-cdp.spec.js.map

package/dist/esm/lib/v3/tests/page-send-cdp.spec.js.map ADDED Viewed

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../lib/v3/tests/page-send-cdp.spec.ts"],
+  "sourcesContent": ["import { test, expect } from \"@playwright/test\";\nimport { V3 } from \"../v3.js\";\nimport { v3TestConfig } from \"./v3.config.js\";\n\ntest.describe(\"Page sendCDP method\", () => {\n  let v3: V3;\n\n  test.beforeEach(async () => {\n    v3 = new V3(v3TestConfig);\n    await v3.init();\n  });\n\n  test.afterEach(async () => {\n    await v3?.close?.().catch(() => {});\n  });\n\n  test(\"sends CDP commands and requires domain to be enabled first\", async () => {\n    const page = v3.context.pages()[0];\n    await page.goto(\"https://example.com\");\n\n    // Try to add a virtual authenticator without enabling WebAuthn first\n    // This should fail because the domain needs to be enabled\n    await expect(\n      page.sendCDP(\"WebAuthn.addVirtualAuthenticator\", {\n        options: {\n          protocol: \"ctap2\",\n          transport: \"usb\",\n          hasResidentKey: false,\n          hasUserVerification: false,\n          isUserVerified: false,\n        },\n      }),\n    ).rejects.toThrow();\n\n    // Enable the WebAuthn domain\n    await page.sendCDP(\"WebAuthn.enable\");\n\n    // Now adding a virtual authenticator should succeed\n    const result = await page.sendCDP<{ authenticatorId: string }>(\n      \"WebAuthn.addVirtualAuthenticator\",\n      {\n        options: {\n          protocol: \"ctap2\",\n          transport: \"usb\",\n          hasResidentKey: false,\n          hasUserVerification: false,\n          isUserVerified: false,\n        },\n      },\n    );\n\n    // Verify we got an authenticator ID back\n    expect(result).toHaveProperty(\"authenticatorId\");\n    expect(typeof result.authenticatorId).toBe(\"string\");\n    expect(result.authenticatorId.length).toBeGreaterThan(0);\n  });\n});\n"],
+  "mappings": "AAAA,SAAS,MAAM,cAAc;AAC7B,SAAS,UAAU;AACnB,SAAS,oBAAoB;AAE7B,KAAK,SAAS,uBAAuB,MAAM;AACzC,MAAI;AAEJ,OAAK,WAAW,YAAY;AAC1B,SAAK,IAAI,GAAG,YAAY;AACxB,UAAM,GAAG,KAAK;AAAA,EAChB,CAAC;AAED,OAAK,UAAU,YAAY;AACzB,UAAM,IAAI,QAAQ,EAAE,MAAM,MAAM;AAAA,IAAC,CAAC;AAAA,EACpC,CAAC;AAED,OAAK,8DAA8D,YAAY;AAC7E,UAAM,OAAO,GAAG,QAAQ,MAAM,EAAE,CAAC;AACjC,UAAM,KAAK,KAAK,qBAAqB;AAIrC,UAAM;AAAA,MACJ,KAAK,QAAQ,oCAAoC;AAAA,QAC/C,SAAS;AAAA,UACP,UAAU;AAAA,UACV,WAAW;AAAA,UACX,gBAAgB;AAAA,UAChB,qBAAqB;AAAA,UACrB,gBAAgB;AAAA,QAClB;AAAA,MACF,CAAC;AAAA,IACH,EAAE,QAAQ,QAAQ;AAGlB,UAAM,KAAK,QAAQ,iBAAiB;AAGpC,UAAM,SAAS,MAAM,KAAK;AAAA,MACxB;AAAA,MACA;AAAA,QACE,SAAS;AAAA,UACP,UAAU;AAAA,UACV,WAAW;AAAA,UACX,gBAAgB;AAAA,UAChB,qBAAqB;AAAA,UACrB,gBAAgB;AAAA,QAClB;AAAA,MACF;AAAA,IACF;AAGA,WAAO,MAAM,EAAE,eAAe,iBAAiB;AAC/C,WAAO,OAAO,OAAO,eAAe,EAAE,KAAK,QAAQ;AACnD,WAAO,OAAO,gBAAgB,MAAM,EAAE,gBAAgB,CAAC;AAAA,EACzD,CAAC;AACH,CAAC;",
+  "names": []
+}

package/dist/esm/lib/v3/tests/perform-understudy-method.spec.js ADDED Viewed

@@ -0,0 +1,98 @@
+import { expect, test } from "@playwright/test";
+import { V3 } from "../v3.js";
+import { v3DynamicTestConfig } from "./v3.dynamic.config.js";
+import { performUnderstudyMethod } from "../handlers/handlerUtils/actHandlerUtils.js";
+import { closeV3 } from "./testUtils.js";
+test.describe("tests performUnderstudyMethod", () => {
+  let v3;
+  test.beforeEach(async () => {
+    v3 = new V3(v3DynamicTestConfig);
+    await v3.init();
+  });
+  test.afterEach(async () => {
+    await closeV3(v3);
+  });
+  test("tests that clicking works", async () => {
+    const page = v3.context.pages()[0];
+    await page.goto(
+      "https://browserbase.github.io/stagehand-eval-sites/sites/no-js-click/"
+    );
+    await performUnderstudyMethod(
+      page,
+      page.mainFrame(),
+      "click",
+      "/html/body/button",
+      [],
+      3e4
+    );
+    const isVisible = await page.locator("#success-msg").isVisible();
+    expect(isVisible).toBe(true);
+  });
+  test("fill sets input value", async () => {
+    const page = v3.context.pages()[0];
+    await page.goto(
+      "https://browserbase.github.io/stagehand-eval-sites/sites/login/"
+    );
+    await performUnderstudyMethod(
+      page,
+      page.mainFrame(),
+      "fill",
+      "/html/body/main/form/div[1]/input",
+      ["Alice"],
+      3e4
+    );
+    const textContent = await page.locator("/html/body/main/form/div[1]/input").inputValue();
+    expect(textContent).toBe("Alice");
+  });
+  test("tests that key presses work", async () => {
+    const page = v3.context.pages()[0];
+    await page.goto(
+      "https://browserbase.github.io/stagehand-eval-sites/sites/key-press/"
+    );
+    await performUnderstudyMethod(
+      page,
+      page.mainFrame(),
+      "press",
+      "xpath=/html",
+      ["Enter"],
+      3e4
+    );
+    const textContent = await page.locator("/html/body/div/div/h1").textContent();
+    expect(textContent).toContain("Enter");
+  });
+  test("tests select option from a dropdown", async () => {
+    const page = v3.context.pages()[0];
+    await page.goto(
+      "https://browserbase.github.io/stagehand-eval-sites/sites/nested-dropdown/"
+    );
+    await performUnderstudyMethod(
+      page,
+      page.mainFrame(),
+      "selectOptionFromDropdown",
+      "xpath=//*[@id='licenseType']",
+      ["Smog Check Technician"],
+      3e4
+    );
+    const inputValue = await page.locator("#licenseType >> option:checked").textContent();
+    expect(inputValue).toBe("Smog Check Technician");
+  });
+  test("tests drag & drop works (start xpath & end xpath)", async () => {
+    const page = v3.context.pages()[0];
+    await page.goto(
+      "https://browserbase.github.io/stagehand-eval-sites/sites/drag-drop/"
+    );
+    await performUnderstudyMethod(
+      page,
+      page.mainFrame(),
+      "dragAndDrop",
+      "xpath=/html/body/div/section[1]/div[1]/div[1]",
+      // start xpath
+      ["/html/body/div/section[2]/div/div[1]"],
+      // end xpath
+      3e4
+    );
+    const droppedContent = await page.locator("/html/body/div/section[2]/div/div[1]/div").textContent();
+    expect(droppedContent).toBe("TEXT: Hello from text");
+  });
+});
+//# sourceMappingURL=perform-understudy-method.spec.js.map

package/dist/esm/lib/v3/tests/perform-understudy-method.spec.js.map ADDED Viewed

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../lib/v3/tests/perform-understudy-method.spec.ts"],
+  "sourcesContent": ["import { expect, test } from \"@playwright/test\";\nimport { V3 } from \"../v3.js\";\nimport { v3DynamicTestConfig } from \"./v3.dynamic.config.js\";\nimport { performUnderstudyMethod } from \"../handlers/handlerUtils/actHandlerUtils.js\";\nimport { closeV3 } from \"./testUtils.js\";\n\ntest.describe(\"tests performUnderstudyMethod\", () => {\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(\"tests that clicking works\", async () => {\n    const page = v3.context.pages()[0];\n    await page.goto(\n      \"https://browserbase.github.io/stagehand-eval-sites/sites/no-js-click/\",\n    );\n\n    await performUnderstudyMethod(\n      page,\n      page.mainFrame(),\n      \"click\",\n      \"/html/body/button\",\n      [],\n      30000,\n    );\n\n    const isVisible = await page.locator(\"#success-msg\").isVisible();\n    expect(isVisible).toBe(true);\n  });\n\n  test(\"fill sets input value\", async () => {\n    const page = v3.context.pages()[0];\n    await page.goto(\n      \"https://browserbase.github.io/stagehand-eval-sites/sites/login/\",\n    );\n\n    await performUnderstudyMethod(\n      page,\n      page.mainFrame(),\n      \"fill\",\n      \"/html/body/main/form/div[1]/input\",\n      [\"Alice\"],\n      30000,\n    );\n\n    const textContent = await page\n      .locator(\"/html/body/main/form/div[1]/input\")\n      .inputValue();\n    expect(textContent).toBe(\"Alice\");\n  });\n\n  test(\"tests that key presses work\", async () => {\n    const page = v3.context.pages()[0];\n    await page.goto(\n      \"https://browserbase.github.io/stagehand-eval-sites/sites/key-press/\",\n    );\n\n    await performUnderstudyMethod(\n      page,\n      page.mainFrame(),\n      \"press\",\n      \"xpath=/html\",\n      [\"Enter\"],\n      30000,\n    );\n\n    const textContent = await page\n      .locator(\"/html/body/div/div/h1\")\n      .textContent();\n    expect(textContent).toContain(\"Enter\");\n  });\n\n  test(\"tests select option from a dropdown\", async () => {\n    const page = v3.context.pages()[0];\n    await page.goto(\n      \"https://browserbase.github.io/stagehand-eval-sites/sites/nested-dropdown/\",\n    );\n\n    await performUnderstudyMethod(\n      page,\n      page.mainFrame(),\n      \"selectOptionFromDropdown\",\n      \"xpath=//*[@id='licenseType']\",\n      [\"Smog Check Technician\"],\n      30000,\n    );\n\n    const inputValue = await page\n      .locator(\"#licenseType >> option:checked\")\n      .textContent();\n    expect(inputValue).toBe(\"Smog Check Technician\");\n  });\n\n  test(\"tests drag & drop works (start xpath & end xpath)\", async () => {\n    const page = v3.context.pages()[0];\n    await page.goto(\n      \"https://browserbase.github.io/stagehand-eval-sites/sites/drag-drop/\",\n    );\n\n    await performUnderstudyMethod(\n      page,\n      page.mainFrame(),\n      \"dragAndDrop\",\n      \"xpath=/html/body/div/section[1]/div[1]/div[1]\", // start xpath\n      [\"/html/body/div/section[2]/div/div[1]\"], // end xpath\n      30000,\n    );\n\n    const droppedContent = await page\n      .locator(\"/html/body/div/section[2]/div/div[1]/div\")\n      .textContent();\n    expect(droppedContent).toBe(\"TEXT: Hello from text\");\n  });\n});\n"],
+  "mappings": "AAAA,SAAS,QAAQ,YAAY;AAC7B,SAAS,UAAU;AACnB,SAAS,2BAA2B;AACpC,SAAS,+BAA+B;AACxC,SAAS,eAAe;AAExB,KAAK,SAAS,iCAAiC,MAAM;AACnD,MAAI;AAEJ,OAAK,WAAW,YAAY;AAC1B,SAAK,IAAI,GAAG,mBAAmB;AAC/B,UAAM,GAAG,KAAK;AAAA,EAChB,CAAC;AAED,OAAK,UAAU,YAAY;AACzB,UAAM,QAAQ,EAAE;AAAA,EAClB,CAAC;AAED,OAAK,6BAA6B,YAAY;AAC5C,UAAM,OAAO,GAAG,QAAQ,MAAM,EAAE,CAAC;AACjC,UAAM,KAAK;AAAA,MACT;AAAA,IACF;AAEA,UAAM;AAAA,MACJ;AAAA,MACA,KAAK,UAAU;AAAA,MACf;AAAA,MACA;AAAA,MACA,CAAC;AAAA,MACD;AAAA,IACF;AAEA,UAAM,YAAY,MAAM,KAAK,QAAQ,cAAc,EAAE,UAAU;AAC/D,WAAO,SAAS,EAAE,KAAK,IAAI;AAAA,EAC7B,CAAC;AAED,OAAK,yBAAyB,YAAY;AACxC,UAAM,OAAO,GAAG,QAAQ,MAAM,EAAE,CAAC;AACjC,UAAM,KAAK;AAAA,MACT;AAAA,IACF;AAEA,UAAM;AAAA,MACJ;AAAA,MACA,KAAK,UAAU;AAAA,MACf;AAAA,MACA;AAAA,MACA,CAAC,OAAO;AAAA,MACR;AAAA,IACF;AAEA,UAAM,cAAc,MAAM,KACvB,QAAQ,mCAAmC,EAC3C,WAAW;AACd,WAAO,WAAW,EAAE,KAAK,OAAO;AAAA,EAClC,CAAC;AAED,OAAK,+BAA+B,YAAY;AAC9C,UAAM,OAAO,GAAG,QAAQ,MAAM,EAAE,CAAC;AACjC,UAAM,KAAK;AAAA,MACT;AAAA,IACF;AAEA,UAAM;AAAA,MACJ;AAAA,MACA,KAAK,UAAU;AAAA,MACf;AAAA,MACA;AAAA,MACA,CAAC,OAAO;AAAA,MACR;AAAA,IACF;AAEA,UAAM,cAAc,MAAM,KACvB,QAAQ,uBAAuB,EAC/B,YAAY;AACf,WAAO,WAAW,EAAE,UAAU,OAAO;AAAA,EACvC,CAAC;AAED,OAAK,uCAAuC,YAAY;AACtD,UAAM,OAAO,GAAG,QAAQ,MAAM,EAAE,CAAC;AACjC,UAAM,KAAK;AAAA,MACT;AAAA,IACF;AAEA,UAAM;AAAA,MACJ;AAAA,MACA,KAAK,UAAU;AAAA,MACf;AAAA,MACA;AAAA,MACA,CAAC,uBAAuB;AAAA,MACxB;AAAA,IACF;AAEA,UAAM,aAAa,MAAM,KACtB,QAAQ,gCAAgC,EACxC,YAAY;AACf,WAAO,UAAU,EAAE,KAAK,uBAAuB;AAAA,EACjD,CAAC;AAED,OAAK,qDAAqD,YAAY;AACpE,UAAM,OAAO,GAAG,QAAQ,MAAM,EAAE,CAAC;AACjC,UAAM,KAAK;AAAA,MACT;AAAA,IACF;AAEA,UAAM;AAAA,MACJ;AAAA,MACA,KAAK,UAAU;AAAA,MACf;AAAA,MACA;AAAA;AAAA,MACA,CAAC,sCAAsC;AAAA;AAAA,MACvC;AAAA,IACF;AAEA,UAAM,iBAAiB,MAAM,KAC1B,QAAQ,0CAA0C,EAClD,YAAY;AACf,WAAO,cAAc,EAAE,KAAK,uBAAuB;AAAA,EACrD,CAAC;AACH,CAAC;",
+  "names": []
+}

package/dist/esm/lib/v3/tests/setinputfiles.spec.js ADDED Viewed

@@ -0,0 +1,126 @@
+import { expect, test } from "@playwright/test";
+import { Buffer } from "buffer";
+import { promises as fs } from "fs";
+import path from "path";
+import crypto from "crypto";
+import { V3 } from "../v3.js";
+import { v3TestConfig } from "./v3.config.js";
+const FILE_UPLOAD_IFRAME_URL = "https://browserbase.github.io/stagehand-eval-sites/sites/file-uploads-iframe/";
+const FILE_UPLOAD_V2_URL = "https://browserbase.github.io/stagehand-eval-sites/sites/file-uploads-2/";
+const RESUME_INPUT = "#resumeUpload";
+const RESUME_SUCCESS = "#resumeSuccess";
+const IMAGES_INPUT = "#imagesUpload";
+const IMAGES_SUCCESS = "#imagesSuccess";
+const AUDIO_INPUT = "#audioUpload";
+const AUDIO_SUCCESS = "#audioSuccess";
+const IFRAME_UPLOAD_INPUT = "/html/body/div/iframe/html/body/div/div[1]/input";
+const IFRAME_SUCCESS = "body > div > iframe >> html > body > div > div:nth-of-type(2)";
+test.describe("tests setInputFiles()", () => {
+  let v3;
+  const fixtures = [];
+  test.beforeEach(async () => {
+    v3 = new V3(v3TestConfig);
+    await v3.init();
+  });
+  test.afterEach(async () => {
+    await v3?.close?.().catch(() => {
+    });
+    await Promise.all(
+      fixtures.splice(0).map((file) => fs.unlink(file).catch(() => {
+      }))
+    );
+  });
+  const createFixture = async (namePrefix, contents, ext = ".txt") => {
+    const normalizedExt = ext.startsWith(".") ? ext : `.${ext}`;
+    const filename = `${namePrefix}-${crypto.randomBytes(4).toString("hex")}${normalizedExt}`;
+    const filePath = path.resolve(process.cwd(), filename);
+    await fs.writeFile(filePath, contents, "utf-8");
+    fixtures.push(filePath);
+    return filePath;
+  };
+  const expectUploadSuccess = async (page, successSelector, expectedText) => {
+    await expect.poll(
+      () => page.evaluate((selector) => {
+        const el = document.querySelector(selector);
+        if (!el) return "";
+        const display = window.getComputedStyle(el).display;
+        if (display === "none") return "";
+        return el.textContent ?? "";
+      }, successSelector),
+      { message: `wait for success message at ${successSelector}` }
+    ).toContain(expectedText);
+  };
+  const getInputFileCount = async (page, inputSelector) => {
+    return await page.evaluate((selector) => {
+      const el = document.querySelector(selector);
+      if (!(el instanceof HTMLInputElement)) return 0;
+      return el.files?.length ?? 0;
+    }, inputSelector);
+  };
+  const expectFileCount = async (page, inputSelector, expected) => {
+    await expect.poll(() => getInputFileCount(page, inputSelector), {
+      message: `wait for file count on ${inputSelector}`
+    }).toBe(expected);
+  };
+  test("deepLocator uploads and validates within iframe", async () => {
+    const page = v3.context.pages()[0];
+    await page.goto(FILE_UPLOAD_IFRAME_URL);
+    const fixture = await createFixture(
+      "iframe-upload",
+      "<p>iframe upload</p>",
+      ".txt"
+    );
+    await page.deepLocator(IFRAME_UPLOAD_INPUT).setInputFiles(path.relative(process.cwd(), fixture));
+    const successLocator = page.deepLocator(IFRAME_SUCCESS);
+    await expect.poll(async () => await successLocator.textContent() ?? "", {
+      message: "wait for iframe upload success"
+    }).toContain("file uploaded successfully");
+  });
+  test("locator uploads resume via relative path string", async () => {
+    const page = v3.context.pages()[0];
+    await page.goto(FILE_UPLOAD_V2_URL);
+    const fixture = await createFixture("resume", "<p>resume</p>", ".pdf");
+    await page.locator(RESUME_INPUT).setInputFiles(path.relative(process.cwd(), fixture));
+    await expectUploadSuccess(page, RESUME_SUCCESS, "Resume uploaded!");
+    await expectFileCount(page, RESUME_INPUT, 1);
+  });
+  test("locator uploads multiple images via absolute paths", async () => {
+    const page = v3.context.pages()[0];
+    await page.goto(FILE_UPLOAD_V2_URL);
+    const first = await createFixture("image-a", "<p>A</p>", ".png");
+    const second = await createFixture("image-b", "<p>B</p>", ".jpeg");
+    await page.locator(IMAGES_INPUT).setInputFiles([first, second]);
+    await expectUploadSuccess(page, IMAGES_SUCCESS, "Images uploaded!");
+    await expectFileCount(page, IMAGES_INPUT, 2);
+  });
+  test("locator uploads audio via payload object", async () => {
+    const page = v3.context.pages()[0];
+    await page.goto(FILE_UPLOAD_V2_URL);
+    await page.locator(AUDIO_INPUT).setInputFiles({
+      name: "voice-sample.mp3",
+      mimeType: "audio/mpeg",
+      buffer: Buffer.from("fake audio bytes", "utf-8")
+    });
+    await expectUploadSuccess(page, AUDIO_SUCCESS, "Audio file uploaded!");
+    await expectFileCount(page, AUDIO_INPUT, 1);
+  });
+  test("locator uploads multiple payload objects to images input", async () => {
+    const page = v3.context.pages()[0];
+    await page.goto(FILE_UPLOAD_V2_URL);
+    await page.locator(IMAGES_INPUT).setInputFiles([
+      {
+        name: "payload-a.png",
+        mimeType: "image/png",
+        buffer: Buffer.from("payload-a", "utf-8")
+      },
+      {
+        name: "payload-b.png",
+        mimeType: "image/png",
+        buffer: Buffer.from("payload-b", "utf-8")
+      }
+    ]);
+    await expectUploadSuccess(page, IMAGES_SUCCESS, "Images uploaded!");
+    await expectFileCount(page, IMAGES_INPUT, 2);
+  });
+});
+//# sourceMappingURL=setinputfiles.spec.js.map

package/dist/esm/lib/v3/tests/setinputfiles.spec.js.map ADDED Viewed

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../lib/v3/tests/setinputfiles.spec.ts"],
+  "sourcesContent": ["import { expect, test } from \"@playwright/test\";\nimport { Buffer } from \"buffer\";\nimport { promises as fs } from \"fs\";\nimport path from \"path\";\nimport crypto from \"crypto\";\nimport type { Page as V3Page } from \"../understudy/page.js\";\nimport { V3 } from \"../v3.js\";\nimport { v3TestConfig } from \"./v3.config.js\";\n\nconst FILE_UPLOAD_IFRAME_URL =\n  \"https://browserbase.github.io/stagehand-eval-sites/sites/file-uploads-iframe/\";\nconst FILE_UPLOAD_V2_URL =\n  \"https://browserbase.github.io/stagehand-eval-sites/sites/file-uploads-2/\";\n\nconst RESUME_INPUT = \"#resumeUpload\";\nconst RESUME_SUCCESS = \"#resumeSuccess\";\nconst IMAGES_INPUT = \"#imagesUpload\";\nconst IMAGES_SUCCESS = \"#imagesSuccess\";\nconst AUDIO_INPUT = \"#audioUpload\";\nconst AUDIO_SUCCESS = \"#audioSuccess\";\nconst IFRAME_UPLOAD_INPUT = \"/html/body/div/iframe/html/body/div/div[1]/input\";\nconst IFRAME_SUCCESS =\n  \"body > div > iframe >> html > body > div > div:nth-of-type(2)\";\n\ntest.describe(\"tests setInputFiles()\", () => {\n  let v3: V3;\n  const fixtures: string[] = [];\n\n  test.beforeEach(async () => {\n    v3 = new V3(v3TestConfig);\n    await v3.init();\n  });\n\n  test.afterEach(async () => {\n    await v3?.close?.().catch(() => {});\n    await Promise.all(\n      fixtures.splice(0).map((file) => fs.unlink(file).catch(() => {})),\n    );\n  });\n\n  const createFixture = async (\n    namePrefix: string,\n    contents: string,\n    ext = \".txt\",\n  ): Promise<string> => {\n    const normalizedExt = ext.startsWith(\".\") ? ext : `.${ext}`;\n    const filename = `${namePrefix}-${crypto.randomBytes(4).toString(\"hex\")}${normalizedExt}`;\n    const filePath = path.resolve(process.cwd(), filename);\n    await fs.writeFile(filePath, contents, \"utf-8\");\n    fixtures.push(filePath);\n    return filePath;\n  };\n\n  const expectUploadSuccess = async (\n    page: V3Page,\n    successSelector: string,\n    expectedText: string,\n  ) => {\n    await expect\n      .poll(\n        () =>\n          page.evaluate((selector) => {\n            const el = document.querySelector(selector);\n            if (!el) return \"\";\n            const display = window.getComputedStyle(el).display;\n            if (display === \"none\") return \"\";\n            return el.textContent ?? \"\";\n          }, successSelector),\n        { message: `wait for success message at ${successSelector}` },\n      )\n      .toContain(expectedText);\n  };\n\n  const getInputFileCount = async (page: V3Page, inputSelector: string) => {\n    return await page.evaluate((selector) => {\n      const el = document.querySelector(selector);\n      if (!(el instanceof HTMLInputElement)) return 0;\n      return el.files?.length ?? 0;\n    }, inputSelector);\n  };\n\n  const expectFileCount = async (\n    page: V3Page,\n    inputSelector: string,\n    expected: number,\n  ) => {\n    await expect\n      .poll(() => getInputFileCount(page, inputSelector), {\n        message: `wait for file count on ${inputSelector}`,\n      })\n      .toBe(expected);\n  };\n\n  test(\"deepLocator uploads and validates within iframe\", async () => {\n    const page = v3.context.pages()[0];\n    await page.goto(FILE_UPLOAD_IFRAME_URL);\n    const fixture = await createFixture(\n      \"iframe-upload\",\n      \"<p>iframe upload</p>\",\n      \".txt\",\n    );\n    await page\n      .deepLocator(IFRAME_UPLOAD_INPUT)\n      .setInputFiles(path.relative(process.cwd(), fixture));\n\n    const successLocator = page.deepLocator(IFRAME_SUCCESS);\n    await expect\n      .poll(async () => (await successLocator.textContent()) ?? \"\", {\n        message: \"wait for iframe upload success\",\n      })\n      .toContain(\"file uploaded successfully\");\n  });\n\n  test(\"locator uploads resume via relative path string\", async () => {\n    const page = v3.context.pages()[0];\n    await page.goto(FILE_UPLOAD_V2_URL);\n    const fixture = await createFixture(\"resume\", \"<p>resume</p>\", \".pdf\");\n    await page\n      .locator(RESUME_INPUT)\n      .setInputFiles(path.relative(process.cwd(), fixture));\n    await expectUploadSuccess(page, RESUME_SUCCESS, \"Resume uploaded!\");\n    await expectFileCount(page, RESUME_INPUT, 1);\n  });\n\n  test(\"locator uploads multiple images via absolute paths\", async () => {\n    const page = v3.context.pages()[0];\n    await page.goto(FILE_UPLOAD_V2_URL);\n    const first = await createFixture(\"image-a\", \"<p>A</p>\", \".png\");\n    const second = await createFixture(\"image-b\", \"<p>B</p>\", \".jpeg\");\n    await page.locator(IMAGES_INPUT).setInputFiles([first, second]);\n    await expectUploadSuccess(page, IMAGES_SUCCESS, \"Images uploaded!\");\n    await expectFileCount(page, IMAGES_INPUT, 2);\n  });\n\n  test(\"locator uploads audio via payload object\", async () => {\n    const page = v3.context.pages()[0];\n    await page.goto(FILE_UPLOAD_V2_URL);\n    await page.locator(AUDIO_INPUT).setInputFiles({\n      name: \"voice-sample.mp3\",\n      mimeType: \"audio/mpeg\",\n      buffer: Buffer.from(\"fake audio bytes\", \"utf-8\"),\n    });\n    await expectUploadSuccess(page, AUDIO_SUCCESS, \"Audio file uploaded!\");\n    await expectFileCount(page, AUDIO_INPUT, 1);\n  });\n\n  test(\"locator uploads multiple payload objects to images input\", async () => {\n    const page = v3.context.pages()[0];\n    await page.goto(FILE_UPLOAD_V2_URL);\n    await page.locator(IMAGES_INPUT).setInputFiles([\n      {\n        name: \"payload-a.png\",\n        mimeType: \"image/png\",\n        buffer: Buffer.from(\"payload-a\", \"utf-8\"),\n      },\n      {\n        name: \"payload-b.png\",\n        mimeType: \"image/png\",\n        buffer: Buffer.from(\"payload-b\", \"utf-8\"),\n      },\n    ]);\n    await expectUploadSuccess(page, IMAGES_SUCCESS, \"Images uploaded!\");\n    await expectFileCount(page, IMAGES_INPUT, 2);\n  });\n});\n"],
+  "mappings": "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",
+  "names": []
+}