testdriverai 6.2.1 → 7.0.0

package/testdriver/acceptance-sdk/hover-image.test.mjs

@@ -0,0 +1,43 @@
+/**
+ * TestDriver SDK - Hover Image Test (Vitest)
+ * Converted from: testdriver/acceptance/hover-image.yaml
+ */
+
+import { afterEach, beforeEach, describe, expect, it } from "vitest";
+import {
+  createTestClient,
+  performLogin,
+  setupTest,
+  teardownTest,
+} from "./setup/testHelpers.mjs";
+
+describe("Hover Image Test", () => {
+  let testdriver;
+
+  beforeEach(async (context) => {
+    testdriver = createTestClient({ task: context.task });
+
+    await setupTest(testdriver);
+  });
+
+  afterEach(async (context) => {
+    await teardownTest(testdriver, { task: context.task });
+  });
+
+  it("should click on shopping cart icon and verify empty cart", async () => {
+    // Perform login first
+    await performLogin(testdriver);
+
+    // Click on the shopping cart icon
+    await testdriver.focusApplication("Google Chrome");
+    const cartIcon = await testdriver.find(
+      "shopping cart icon next to the Cart text in the top right corner",
+    );
+
+    await cartIcon.click();
+
+    // Assert that you see an empty shopping cart
+    const result = await testdriver.assert("Your cart is empty");
+    expect(result).toBeTruthy();
+  });
+});

package/testdriver/acceptance-sdk/hover-text-with-description.test.mjs

@@ -0,0 +1,50 @@
+/**
+ * TestDriver SDK - Hover Text With Description Test (Vitest)
+ * Converted from: testdriver/acceptance/hover-text-with-description.yaml
+ */
+
+import { afterEach, beforeEach, describe, expect, it } from "vitest";
+import {
+  createTestClient,
+  performLogin,
+  setupTest,
+  teardownTest,
+} from "./setup/testHelpers.mjs";
+
+describe("Hover Text With Description Test", () => {
+  let testdriver;
+
+  beforeEach(async (context) => {
+    testdriver = createTestClient({ task: context.task });
+
+    await setupTest(testdriver);
+  });
+
+  afterEach(async (context) => {
+    await teardownTest(testdriver, { task: context.task });
+  });
+
+  it("should add TestDriver Hat to cart and verify", async () => {
+    // Perform login first
+    await performLogin(testdriver);
+
+    // Click on "Add to Cart" under TestDriver Hat
+    await testdriver.focusApplication("Google Chrome");
+    const addToCartButton = await testdriver.find(
+      "Add to Cart, add to cart button under TestDriver Hat",
+    );
+    await addToCartButton.click();
+
+    // Click on the cart
+    await testdriver.focusApplication("Google Chrome");
+    const cartButton = await testdriver.find(
+      "Cart, cart button in the top right corner",
+    );
+    await cartButton.click();
+
+    // Assert the TestDriver Hat is in the cart
+    await testdriver.focusApplication("Google Chrome");
+    const result = await testdriver.assert("TestDriver Hat is in the cart");
+    expect(result).toBeTruthy();
+  });
+});

package/testdriver/acceptance-sdk/hover-text.test.mjs

@@ -0,0 +1,41 @@
+/**
+ * TestDriver SDK - Hover Text Test (Vitest)
+ * Converted from: testdriver/acceptance/hover-text.yaml
+ */
+
+import { afterEach, beforeEach, describe, expect, it } from "vitest";
+import {
+  createTestClient,
+  setupTest,
+  teardownTest,
+} from "./setup/testHelpers.mjs";
+
+describe("Hover Text Test", () => {
+  let testdriver;
+
+  beforeEach(async (context) => {
+    testdriver = createTestClient({ task: context.task });
+
+    await setupTest(testdriver);
+  });
+
+  afterEach(async (context) => {
+    await teardownTest(testdriver, { task: context.task });
+  });
+
+  it("should click Sign In and verify error message", async () => {
+    // Click on Sign In button using new find() API
+    await testdriver.focusApplication("Google Chrome");
+
+    const signInButton = await testdriver.find(
+      "Sign In, black button below the password field",
+    );
+    await signInButton.click();
+
+    // Assert that an error shows that fields are required
+    const result = await testdriver.assert(
+      "an error shows that fields are required",
+    );
+    expect(result).toBeTruthy();
+  });
+});

package/testdriver/acceptance-sdk/match-image.test.mjs

@@ -0,0 +1,48 @@
+/**
+ * TestDriver SDK - Match Image Test (Vitest)
+ * Converted from: testdriver/acceptance/match-image.yaml
+ */
+
+import path, { dirname } from "path";
+import { fileURLToPath } from "url";
+import { afterEach, beforeEach, describe, expect, it } from "vitest";
+import {
+  createTestClient,
+  performLogin,
+  setupTest,
+  teardownTest,
+} from "./setup/testHelpers.mjs";
+
+// Get the directory of the current module
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+describe("Match Image Test", () => {
+  let testdriver;
+
+  beforeEach(async (context) => {
+    testdriver = createTestClient({ task: context.task });
+
+    await setupTest(testdriver);
+  });
+
+  afterEach(async (context) => {
+    await teardownTest(testdriver, { task: context.task });
+  });
+
+  it("should match shopping cart image and verify empty cart", async () => {
+    // Perform login first
+    await performLogin(testdriver);
+
+    // Match and click the shopping cart icon
+    const cartImagePath = path.resolve(
+      __dirname,
+      "../../_testdriver/acceptance/screenshots/cart.png",
+    );
+    await testdriver.matchImage(cartImagePath, "click");
+
+    // Assert that you see an empty shopping cart
+    const result = await testdriver.assert("Your cart is empty");
+    expect(result).toBeTruthy();
+  });
+});

package/testdriver/acceptance-sdk/press-keys.test.mjs

@@ -0,0 +1,64 @@
+/**
+ * TestDriver SDK - Press Keys Test (Vitest)
+ * Converted from: testdriver/acceptance/press-keys.yaml
+ */
+
+import { afterEach, beforeEach, describe, expect, it } from "vitest";
+import {
+  createTestClient,
+  setupTest,
+  teardownTest,
+} from "./setup/testHelpers.mjs";
+
+describe("Press Keys Test", () => {
+  let testdriver;
+
+  beforeEach(async (context) => {
+    testdriver = createTestClient({ task: context.task });
+
+    await setupTest(testdriver);
+  });
+
+  afterEach(async (context) => {
+    await teardownTest(testdriver, { task: context.task });
+  });
+
+  it("should create tabs and navigate using keyboard shortcuts", async () => {
+    await testdriver.focusApplication("Google Chrome");
+    const signInButton = await testdriver.find(
+      "Sign In, black button below the password field",
+    );
+    await signInButton.click();
+
+    // Open new tab
+    await testdriver.pressKeys(["ctrl", "t"]);
+
+    // Poll for "Learn more" to appear
+    let learnMore = await testdriver.find("Learn more");
+    for (let i = 0; i < 10; i++) {
+      learnMore = await learnMore.find();
+      if (learnMore.found()) break;
+      await new Promise((resolve) => setTimeout(resolve, 500));
+    }
+
+    // Open DevTools
+    await testdriver.pressKeys(["ctrl", "shift", "i"]);
+
+    // Poll for "Elements" to appear
+    let elements = await testdriver.find("Elements");
+    for (let i = 0; i < 10; i++) {
+      elements = await elements.find();
+      if (elements.found()) break;
+      await new Promise((resolve) => setTimeout(resolve, 500));
+    }
+
+    // Open another tab and navigate
+    await testdriver.pressKeys(["ctrl", "t"]);
+    await testdriver.type("google.com");
+    await testdriver.pressKeys(["enter"]);
+
+    // Assert Google appears
+    const result = await testdriver.assert("google appears");
+    expect(result).toBeTruthy();
+  });
+});

package/testdriver/acceptance-sdk/prompt.test.mjs

@@ -0,0 +1,45 @@
+/**
+ * TestDriver SDK - Prompt Test (Vitest)
+ * Converted from: testdriver/acceptance/prompt.yaml
+ */
+
+import { afterEach, beforeEach, describe, expect, it } from "vitest";
+import {
+  createTestClient,
+  setupTest,
+  teardownTest,
+} from "./setup/testHelpers.mjs";
+
+describe.skip("Prompt Test", () => {
+  let testdriver;
+
+  beforeEach(async (context) => {
+    testdriver = createTestClient({ task: context.task });
+
+    await setupTest(testdriver);
+  });
+
+  afterEach(async (context) => {
+    await teardownTest(testdriver, { task: context.task });
+  });
+
+  it("should execute AI-driven prompts", async () => {
+    // Note: The SDK doesn't have a direct equivalent to YAML prompts without commands.
+    // This would typically be handled by the AI agent interpreting natural language.
+    // For SDK usage, you need to use explicit commands.
+
+    // Original prompts were:
+    // 1. "log in"
+    // 2. "add an item to the cart"
+    // 3. "click on the cart icon"
+    // 4. "complete checkout"
+
+    // This test is skipped as it requires explicit SDK implementation
+    // You would need to implement these as explicit SDK calls
+
+    await testdriver.ai("log in");
+
+    const result = await testdriver.assert("the testdriver sandbox is visible");
+    expect(result).toBeTruthy();
+  });
+});

package/testdriver/acceptance-sdk/scroll-keyboard.test.mjs

@@ -0,0 +1,52 @@
+/**
+ * TestDriver SDK - Scroll Keyboard Test (Vitest)
+ * Converted from: testdriver/acceptance/scroll-keyboard.yaml
+ */
+
+import { afterEach, beforeEach, describe, expect, it } from "vitest";
+import {
+  createTestClient,
+  setupTest,
+  teardownTest,
+} from "./setup/testHelpers.mjs";
+
+describe("Scroll Keyboard Test", () => {
+  let testdriver;
+
+  beforeEach(async (context) => {
+    testdriver = createTestClient({
+      task: context.task,
+      redrawThreshold: 0.5, // Higher threshold for scroll test
+    });
+    await setupTest(testdriver);
+  });
+
+  afterEach(async (context) => {
+    await teardownTest(testdriver, { task: context.task });
+  });
+
+  it("should navigate to webhamster.com and scroll with keyboard", async () => {
+    // Navigate to https://www.webhamster.com/
+    await testdriver.focusApplication("Google Chrome");
+    const urlBar = await testdriver.find(
+      "testdriver-sandbox.vercel.app/login, the URL in the omnibox showing the current page",
+    );
+    await urlBar.click();
+    await testdriver.pressKeys(["ctrl", "a"]);
+    await testdriver.type("https://www.webhamster.com/");
+    await testdriver.pressKeys(["enter"]);
+
+    // Scroll down with keyboard 1000 pixels
+    const heading = await testdriver.find(
+      "The Hamster Dance, large heading at top of page",
+    );
+    await heading.click();
+    await testdriver.scroll("down", 1000);
+
+    // Assert the page is scrolled down
+    const result = await testdriver.assert(
+      "the hamster dance heading is not visible",
+    );
+    expect(result).toBeTruthy();
+  });
+});

package/testdriver/acceptance-sdk/scroll-until-image.test.mjs

@@ -0,0 +1,51 @@
+/**
+ * TestDriver SDK - Scroll Until Image Test (Vitest)
+ * Converted from: testdriver/acceptance/scroll-until-image.yaml
+ */
+
+import { afterEach, beforeEach, describe, expect, it } from "vitest";
+import {
+  createTestClient,
+  setupTest,
+  teardownTest,
+} from "./setup/testHelpers.mjs";
+
+describe("Scroll Until Image Test", () => {
+  let testdriver;
+
+  beforeEach(async (context) => {
+    testdriver = createTestClient({ task: context.task });
+
+    await setupTest(testdriver);
+  });
+
+  afterEach(async (context) => {
+    await teardownTest(testdriver, { task: context.task });
+  });
+
+  it("should scroll until brown colored house image appears", async () => {
+    // Navigate to Wikipedia page
+    await testdriver.pressKeys(["ctrl", "l"]);
+    await testdriver.type("https://en.wikipedia.org/wiki/Leonardo_da_Vinci");
+    await testdriver.pressKeys(["enter"]);
+
+    // sleep for 5 seconds
+    await new Promise((r) => setTimeout(r, 5000));
+
+    // Click on heading
+    const heading = await testdriver.find(
+      "Leonardo Da Vinci, the page heading",
+      0,
+    );
+    await heading.click();
+
+    // Scroll until image appears
+    await testdriver.scrollUntilImage("a brown colored house", "down", 10000);
+
+    // Assert image of brown colored house appears on screen
+    const result = await testdriver.assert(
+      "image of brown colored house appears on screen",
+    );
+    expect(result).toBeTruthy();
+  });
+});

package/testdriver/acceptance-sdk/scroll-until-text.test.mjs

@@ -0,0 +1,42 @@
+/**
+ * TestDriver SDK - Scroll Until Text Test (Vitest)
+ * Converted from: testdriver/acceptance/scroll-until-text.yaml
+ */
+
+import { afterEach, beforeEach, describe, expect, it } from "vitest";
+import {
+  createTestClient,
+  performLogin,
+  setupTest,
+  teardownTest,
+} from "./setup/testHelpers.mjs";
+
+describe("Scroll Until Text Test", () => {
+  let testdriver;
+
+  beforeEach(async (context) => {
+    testdriver = createTestClient({ task: context.task });
+
+    await setupTest(testdriver);
+  });
+
+  afterEach(async (context) => {
+    await teardownTest(testdriver, { task: context.task });
+  });
+
+  it('should scroll until "testdriver socks" appears', async () => {
+    // Perform login first
+    await performLogin(testdriver);
+
+    // Scroll until text appears
+    await testdriver.focusApplication("Google Chrome");
+    await testdriver.scrollUntilText("testdriver socks", "down");
+
+    // Assert testdriver socks appears on screen
+    await testdriver.focusApplication("Google Chrome");
+    const result = await testdriver.assert(
+      "TestDriver Socks appears on screen",
+    );
+    expect(result).toBeTruthy();
+  });
+});

package/testdriver/acceptance-sdk/scroll.test.mjs

@@ -0,0 +1,50 @@
+/**
+ * TestDriver SDK - Scroll Test (Vitest)
+ * Converted from: testdriver/acceptance/scroll.yaml
+ */
+
+import { afterEach, beforeEach, describe, expect, it } from "vitest";
+import {
+  createTestClient,
+  setupTest,
+  teardownTest,
+} from "./setup/testHelpers.mjs";
+
+describe("Scroll Test", () => {
+  let testdriver;
+
+  beforeEach(async (context) => {
+    testdriver = createTestClient({ task: context.task });
+
+    await setupTest(testdriver);
+  });
+
+  afterEach(async (context) => {
+    await teardownTest(testdriver, { task: context.task });
+  });
+
+  it("should navigate and scroll down the page", async () => {
+    // Navigate to webhamster.com
+    await testdriver.focusApplication("Google Chrome");
+    const urlBar = await testdriver.find(
+      "testdriver-sandbox.vercel.app/login, the URL in the omnibox showing the current page",
+    );
+    await urlBar.click();
+    await testdriver.pressKeys(["ctrl", "a"]);
+    await testdriver.type("https://www.webhamster.com/");
+    await testdriver.pressKeys(["enter"]);
+
+    // Wait for page to load and click heading
+    const heading = await testdriver.find(
+      "The Hamster Dance, large heading at top of page",
+    );
+    await heading.click();
+
+    // Scroll down
+    await testdriver.scroll("down", 1000);
+
+    // Assert page is scrolled
+    const result = await testdriver.assert("the page is scrolled down");
+    expect(result).toBeTruthy();
+  });
+});

package/testdriver/acceptance-sdk/setup/globalTeardown.mjs

@@ -0,0 +1,11 @@
+/**
+ * Vitest Global Teardown
+ * Saves test results and dashcam URLs after all tests complete
+ */
+
+import { saveTestResults } from "./testHelpers.mjs";
+
+export default async function globalTeardown() {
+  console.log("\n🎬 Saving test results and dashcam URLs...");
+  saveTestResults();
+}