Assert that a page loaded - TestDriver

This test opens a login page in Chrome, saves a screenshot, and asserts that the page loaded.

Watch it run

The test

assert.test.mjs

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

describe("Assert Test", () => {
  it("should assert the testdriver login page shows", async (context) => {
    const testdriver = TestDriver(context);

    await testdriver.provision.chrome({
      url: 'http://testdriver-sandbox.vercel.app/login',
    });

    // Save a screenshot to .testdriver/screenshots for debugging
    await testdriver.screenshot();

    // Assert the TestDriver.ai Sandbox login page is displayed
    const result = await testdriver.assert(
      "the TestDriver.ai Sandbox login page is displayed",
    );

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

How it works

provision.chrome({ url }) starts Chrome in the sandbox and opens the URL.
screenshot() saves the screen to .testdriver/screenshots/ and returns the file path. Use it to debug failures later.
assert() asks the AI whether a statement about the screen is true.
assert() throws when the statement is false, so the test fails at that line.
The expect() after it makes the check explicit in the test.

Run it

The test is in the TestDriver SDK repository. Clone it, install dependencies, and run the file:

git clone https://github.com/testdriverai/testdriverai
cd testdriverai
npm install
npx vitest run examples/assert.test.mjs

The test reads your API key from TD_API_KEY. Create a key at console.testdriver.ai/team/api-keys. Then set it in your environment or a .env file.