Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.testdriver.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Demo Test Run

Watch this test execute in a real sandbox environment:

​
Source Code

ai.test.mjs
/**
 * TestDriver SDK - AI Test (Vitest)
 * Tests the AI exploratory loop (ai) functionality
 */

import { describe, expect, it } from "vitest";
import { TestDriver } from "testdriverai/vitest/hooks";

describe("AI Test", () => {
  it("should use ai to search for testdriver on Google", async (context) => {
    const testdriver = TestDriver(context, { ip: context.ip || process.env.TD_IP});
    
    // provision.chrome() automatically calls ready() and starts dashcam
    await testdriver.provision.chrome({
      url: 'https://duckduckgo.com',
    });

    // Use ai to search for testdriver
    let aiRes = await testdriver.ai("click on the empty search box, type 'testdriver', and hit enter.");

    console.log("AI response:", aiRes);

    // Assert the search results are displayed
    const result = await testdriver.assert(
      "search results for testdriver are visible",
    );

    expect(result).toBeTruthy();
  });
});

​
Running This Example

# Clone the TestDriver repository
git clone https://github.com/testdriverai/testdriverai

# Install dependencies
cd testdriverai
npm install

# Run this specific example
npx vitest run examples/ai.test.mjs
Make sure you have TD_API_KEY set in your environment. Get one at testdriver.ai.