Use keyboard shortcuts - TestDriver

This test drives Chrome with keyboard shortcuts to open tabs and DevTools, then types a URL.

Watch it run

The test

press-keys.test.mjs

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

describe("Press Keys Test", () => {
  it("should create tabs and navigate using keyboard shortcuts", async (context) => {
    const testdriver = TestDriver(context);
    await testdriver.provision.chrome({ url: 'http://testdriver-sandbox.vercel.app/login' });

    const signInButton = await testdriver.find(
      "Sign In, black button below the password field",
    );
    await signInButton.click();

    // Open new tab
    await testdriver.pressKeys(["ctrl", "t"]);

    // Wait for the new tab page to load
    let imagesLink = await testdriver.find("Images", {timeout: 5000});

    expect(imagesLink.found()).toBeTruthy();

    // Open DevTools
    await testdriver.pressKeys(["ctrl", "shift", "i"]);

    // Wait for the DevTools Elements panel
    let elements = await testdriver.find("Elements", {timeout: 5000});
    expect(elements.found()).toBeTruthy();

    // 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();
  });
});

How it works

pressKeys() presses an array of keys together.
['ctrl', 't'] opens a new tab, and ['ctrl', 'shift', 'i'] opens DevTools.
After each shortcut, find() with a short timeout waits for what the shortcut should reveal. This confirms the shortcut worked.
type() types into the focused element, here the new tab’s address bar.

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/press-keys.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.