Test Generation

Learn how to generate test with TestDriver!

If you need any help along the way, be sure to Join our Discord!

Quickstart

The easiest way to generate tests for your app is to use the form below. This will generate dozens of tests for you in a new GitHub repository.

After filling out this form, you'll receive three emails:

1. When the generation job begins

2. When the generation job completes

3. A notification from GitHub notifying you that you've been added as a collaborator on the repository

Reviewing Pull Requests

When the generation job completes, you'll get an email with a link to the new pull requests. Each pull request description will contain:

1. The CLI commands used to generate the test (description)

2. The test result

3. A video recording to review (with logs and network requests) on Dashcam

The pull request will also contain a YML regression test. Here is an example of a generated test

TestDriver.ai / Generate Test / test-contact-us-link by github-actions[bot] · Pull Request #6 · testdriverbot/pubnubcom-1729121039116GitHub

Reviewing Pull Requests

Click on the Dashcam preview to see a video of the AI completing the test as well as the AI logs, console logs, and network requests. For more on reviewing test results, see #Debugging.

Making Changes

TestDriver runs exploratory tests using the /explore command. This means it might try multiple times to accomplish a goal.

Not every test will complete the objective entirely, but the steps that do complete successfully make great regression tests and it usually only takes a little modification to make a successful test!

We recommend:

1. Deleting the test steps that did not complete successfully.

2. Modifying the test steps if required. See YML Schema for details on each TestDriver command

You can clone this repository and run the tests locally using the TestDriver CLI. See Local Development for more.

Deploying Your Test (Requires Upgrade)

This repository is set up to automatically run any merged regression tests! You'll need an API key to do so, and you can only get one by upgrading your account to Pro or higher.

Getting an API Key

On've you've acquired an API key, create a new GitHub secret named TESTDRIVER_API_KEYand use the key as the value.

Where to go from here?

• Read the GitHub Setup guide for more information on integrating with GitHub.

• Scan the Action Output to learn how to send emails and Slack notifications on test failures

• Check out the CLI Commands for details on the high level commands TestDriver uses to generate tests or learn about regression tests in YML Schema

• Follow the Local Development guide to create and debug tests on your local machine