Recording Test Flows with Light

1. Install Light QA Extension: If you haven't already, install the extension from the Chrome Web Store. See our installation guide for details.
2. Navigate to Your Website: Open the website or web application you want to test in your browser
3. Open Light QA Panel: Click the Light QA extension icon in your browser toolbar
4. Click "Start Recording": Begin capturing your interactions
5. Interact Naturally: Perform the actions you want to test - click, type, navigate, etc.
6. Stop Recording: Click "Stop Recording" when you're finished

UI Interactions

• Clicks on buttons, links, and interactive elements
• Text input into form fields
• Dropdown selections
• Checkbox and radio button selections
• Page navigation and URL changes
• Scroll actions
• Hover events

Selectors

• Stable CSS selectors for each element
• XPath expressions
• Element IDs and classes
• Multiple selector strategies for reliability

Network Activity

• All API calls made during the flow
• Request and response details
• Headers and payloads
• Network timing information

Before Recording

• Plan Your Flow: Think through the user journey you want to test before starting
• Clean State: Start from a known state (e.g., logged out, on homepage)
• Close Unnecessary Tabs: Reduce noise and focus on your target application
• Prepare Test Data: Have test credentials or data ready if needed

During Recording

• Work at a Normal Pace: Don't rush - Light captures accurately even with natural timing
• Wait for Page Loads: Allow pages to fully load before clicking next elements
• Use Clear Actions: Click directly on elements rather than nearby areas
• Complete the Flow: Record the entire user journey from start to finish
• Avoid Unnecessary Actions: Skip exploratory clicking that's not part of your test

After Recording

• Review the Steps: Check that all intended actions were captured
• Verify Selectors: Light generates stable selectors, but review them
• Add Assertions: Consider adding verification steps for important outcomes
• Name Your Recording: Give it a descriptive name for easy identification

1. Start from the login page
2. Enter credentials (Light will capture the input)
3. Click the login/submit button
4. Wait for redirect to dashboard or home page
5. Verify successful login (check for welcome message or user menu)

Tip: Use variables or environment-specific credentials when exporting to Playwright for better security.

1. Navigate to the form page
2. Fill in each field systematically
3. Select dropdown values
4. Check/uncheck checkboxes as needed
5. Click submit or save
6. Verify success message or confirmation

1. Start from homepage or landing page
2. Navigate through menu items or links
3. Visit different pages or sections
4. Use breadcrumbs or back buttons
5. Verify correct pages load

• View Steps List: See all captured actions in chronological order
• Edit Actions: Modify individual steps if needed
• Remove Steps: Delete unnecessary or incorrect captures
• Reorder Steps: Rearrange actions if the order needs adjustment
• Add Manual Steps: Insert additional actions or assertions
• Verify Selectors: Check and adjust selectors for better stability

Export Formats

• Playwright Python: Ready-to-run Python scripts using Playwright
• Playwright JavaScript: Ready-to-run JavaScript/TypeScript scripts
• API Collection (JSON): Export captured API calls as a JSON collection

After Export

1. Save the exported file to your project
2. Review the generated code
3. Install Playwright dependencies if needed
4. Run the test to verify it works
5. Integrate into your test suite

• Captures entire session as a video file
• Perfect for debugging failed tests
• Useful for sharing with team members
• Helps with documentation and training

Enable video recording before starting your recording session.

• View all network requests made during the flow
• Inspect request/response details
• Export API calls as a separate collection
• Use for API testing and documentation

Steps Not Being Captured

• Ensure recording is started before interacting with the page
• Check that the extension icon shows "Recording" status
• Refresh the page and start a new recording if needed
• Verify the extension has necessary permissions

Unstable Selectors

• Light generates multiple selector strategies automatically
• Review and edit selectors manually if needed
• Use more specific selectors (IDs, data attributes) when possible
• Consider adding wait conditions in the exported code

Export Not Working

• Make sure you've stopped the recording before exporting
• Verify at least one interaction was captured
• Check your browser's download settings
• Try exporting again or restart the extension

• Learn about advanced extension features
• Explore writing tests in plain English with Terminal
• Check out API testing features for comprehensive test coverage