Your First Test

This guide will walk you through creating your first automated test using TrueAssert. You can create tests in three ways: browser plugin recording, AI generation, or manual creation. We'll start with the simplest method.

Prerequisites

Before creating your first test, make sure you have:

• ✅ A TrueAssert account (Account Setup)

• ✅ Browser plugin installed and connected (Installation)

• ✅ Access to the website you want to test

Method 1: Browser Plugin Recording (Easiest)

This is the quickest way to create a test - just record your actions!

Step 1: Start Recording

1. Navigate to the website you want to test

2. Click the TrueAssert extension icon in your Chrome toolbar

3. Click the large "Record" button

4. A red recording indicator will appear on the webpage

Step 2: Perform Actions

Simply use the website as you normally would:

• Click buttons

• Fill out forms

• Navigate between pages

• Interact with elements

Each action is automatically captured and the step count updates in real-time in the extension badge.

Step 3: Stop and Save

1. Click "Stop and Save" (saves immediately) or "Stop" (review first)

2. If you clicked "Stop", review your recorded steps

3. Enter a test name (e.g., "Login Flow Test")

4. Click "Save" to create the test in TrueAssert

5. Click "View Test" to open the test in your dashboard

What Gets Created

• A new test with status DRAFTING

• All recorded steps with:

  • Action type (CLICK, FILL, GOTO, WAIT, etc.)

  • XPath selectors (automatically generated)

  • Values (for form inputs)

• Test is ready for review and execution

Method 2: AI Test Generation

Create tests by describing what you want to test in plain English.

Step 1: Navigate to Create Test

1. Log into TrueAssert

2. Go to Create Test page or click "Create Test" in the navigation

3. You'll see the test creation form

Step 2: Fill Out the Form

The form requires:

• Test name: A descriptive name (e.g., "Test user login flow")

  • Minimum 3 characters

  • Example: "Test the user login and registration flows"

• Target URL: The website URL you want to test

  • Must be a valid URL

  • Example: https://example.com/login

• AI prompt: Describe what you want to test in detail

  • Minimum 10 characters

  • Be specific about the actions and validations

  • Example: "Create a test that navigates to the login page, fills in the username and password fields, clicks the login button, and verifies that the user is redirected to the dashboard"

Step 3: Configure Options

Login Required (checkbox):

• Check this if the test requires authentication

• TrueAssert will automatically handle login flow

• Requires login settings to be configured in project settings

Use Predefined Session (checkbox):

• Check this to reuse an existing authenticated session

• Faster than full login flow

• Requires session data to exist for the project

Let AI decide if multiple test cases need to be created (checkbox):

• Default: checked

• Allows AI to create multiple related test cases if needed

Note: "Login Required" and "Use Predefined Session" are mutually exclusive - you can only select one.

Step 4: Submit and Wait

1. Click "Create Test"

2. The test is created with status DRAFTING

3. You're redirected to the test detail page

4. The background processor will generate test steps automatically

5. Monitor the status - it will change from DRAFTING → REVIEW → READY

What Happens Behind the Scenes

1. Test Creation: A new Test object is created in the database

2. Background Processing: The TestGenerator processes the test

3. AI Generation: LLM analyzes your prompt and generates test steps

4. Login Flow (if enabled): If login_required=True, login flow executes automatically

5. Status Updates: Test status updates as steps are generated

Method 3: Manual Test Creation

You can also create tests manually using the web interface, but this is more advanced. See the Manual Test Creation Guide for details.

Understanding Test Status

After creation, your test goes through these statuses:

• DRAFTING: Test is being generated by AI/background processor

• REVIEW: Test steps are generated, ready for review

• READY: Test is ready to execute

• ARCHIVED: Test has been archived (hidden from main list)

Next Steps

After creating your first test:

1. Review Test Steps: Go to the test detail page and review generated steps

2. Edit if Needed: Modify steps, selectors, or values

3. Run the Test: Click "Run Test" to execute it

4. View Results: Check execution logs, screenshots, and step results

Common First Test Scenarios

Simple Page Navigation

Test Name: "Navigate to homepage" Target URL: https://example.com AI Prompt: "Navigate to the homepage and verify the page loads correctly"

Form Submission

Test Name: "Contact form submission" Target URL: https://example.com/contact AI Prompt: "Fill out the contact form with test data and submit it, then verify a success message appears"

Login Flow

Test Name: "User login test" Target URL: https://example.com/login AI Prompt: "Test the login flow by entering credentials and verifying successful login" Login Required: ✅ Checked (requires login settings configured)

Troubleshooting

Test Stuck in DRAFTING

• Check that agents are available (go to Agents page)

• Verify the background processor is running

• Check server logs for errors

No Steps Generated

• Verify your AI prompt is detailed enough (minimum 10 characters)

• Check that the target URL is accessible

• Review error messages on the test detail page

Login Flow Fails

• Ensure login settings are configured in project settings

• Verify login test exists and is in READY status

• Check that login URL, username, and password are correct

Related Guides

• Browser Plugin Recording - Advanced recording features

• AI Test Generation - Writing effective prompts

• Running Tests - Execute your tests

• Session Management - Set up authentication

---

← Back to Getting Started | Next: Core Concepts →