Your First Test

Let's walk through creating a complete login test for a web application.

Prerequisites

Example: Testing a Login Flow

We'll create a test that:

  1. Navigates to the login page
  2. Enters credentials
  3. Submits the form
  4. Verifies successful login

Step 1: Create the Test Case

  1. Open your project and navigate to a test suite
  2. Click New Test
  3. Name it "User Login"
  4. Choose Generate from Text

Step 2: Describe the Flow

Enter a description of what the test should do:

Login Flow:
1. Click on the "Sign In" link in the navigation
2. Enter the email address in the email field
3. Enter the password in the password field
4. Click the "Log In" button
5. Wait until the user dashboard is visible

Click Generate and the AI will create structured steps.

Step 3: Review Generated Steps

The AI will generate steps like:

StepDescriptionWait Until
1Click on the "Sign In" link in the navigationSign in form is visible
2Enter the email address in the email field-
3Enter the password in the password field-
4Click the "Log In" button-
5Wait until the user dashboard is visibleDashboard heading visible

Step 4: Add Test Data

For steps that need input data, add the data field:

Step 2 - Email: {{run.email}}

Step 3 - Password: testpassword123

Using the {{run.email}} placeholder generates a unique email for each test run. See Dynamic Placeholders for more options.

Step 5: Add Assertions

Assertions verify your test passed. Add assertions like:

Step 6: Run the Test

  1. Click the Run button
  2. A live browser preview opens showing the test execution
  3. Watch as each step is executed
  4. Green checkmarks indicate successful steps
  5. Review the AI's reasoning for each action

Step 7: Publish the Test

Once your test passes:

  1. Click Publish to move steps from draft to published
  2. Published tests can be run in CI/CD pipelines
  3. Draft changes don't affect CI/CD runs until published

Common Patterns

Using Authentication Settings

Instead of hardcoding credentials in steps, configure them in project or suite settings:

  1. Go to Project Settings or Suite Settings
  2. Add Email and Password under Authentication
  3. The AI will use these credentials when steps mention "enter email" or "enter password"

Creating a Login Suite

For apps requiring authentication:

  1. Create a suite named "Login" (or similar)
  2. Mark it as a Login Suite in settings
  3. After successful run, cookies are saved automatically
  4. Other test suites can reuse this authenticated state

Handling Wait Conditions

Add waitUntil to steps that trigger navigation or loading:

Step: Click the "Submit" button
Wait Until: Success message appears

The AI will poll until the condition is met (30 second timeout).

Next Steps