Setting up TestDriver CLI

Install Node.js

Ensure you have Node.js (v16 or higher) installed.

Check your Node.js version:

node -v

If not installed, download it from Node.js Official Website.

Install NPM

npm: Comes with Node.js. Verify npm is installed:

npm -v

Set Up Your Test Runner

In your project directory, run the interactive setup process:

npx testdriverai@latest init

TestDriver requires a runner to execute tests. You can use either a hosted sandbox or your own computer.

TestDriver Sandbox - Run tests in a ephemeral linux virtual machine. Recommended for ease of use, added privacy, and parallelization. Requires a TestDriver API key.
Local Runner - Run tests on your own computer. Recommended for working with existing user sessions, files, and applications. Requires additional setup.

Running init in your project directory and choose “yes” for the sandbox option. This will prompt you for your API key.

Beginning setup...
✔ Use TestDriver Sandbox Runners? (Recommended) … yes
? API KEY (from https://app.testdriver.ai/team) › ********

This will write the TD_VM and TD_API_KEY values to .env file in your project directory.

Run TestDriver in Interactive Mode

Start TestDriver in interactive mode.

npx testdriverai@latest

You should see a prompt like this:

Howdy! I'm TestDriver v4.2.26

Self-Driving Tests

TestDriver will come up with it’s own ideas for testing.

Write custom tests