Installing the Light QA Extension

Learn how to install and set up the Light QA Assistant browser extension to record test flows and export them as Playwright scripts.

What is Light QA Extension?

Light QA Assistant is a powerful browser extension that lets you record your interactions with any website and automatically generate production-ready Playwright scripts. It captures clicks, inputs, navigation, and even API calls during your recording session.

Key Features

  • Record test flows naturally by interacting with your website
  • Auto-generate stable CSS/XPath selectors
  • Export to Playwright Python or JavaScript
  • Capture API calls and network requests
  • Optional video recording of sessions
  • Basic accessibility and GDPR compliance checks

Installation Steps for Chrome/Edge/Brave

  1. Open Chrome Web Store: Visit the Light QA Assistant extension page
  2. Click "Add to Chrome": You'll see an "Add to Chrome" button on the extension page
  3. Confirm Installation: A popup will appear asking for confirmation. Click "Add Extension"
  4. Verify Installation: Look for the Light QA icon in your browser toolbar (usually in the top-right corner)
  5. Pin the Extension (Optional): Right-click the extension icon and select "Pin" to keep it visible

First-Time Setup

After installation, here's how to get started:

  1. Click the Extension Icon: Click the Light QA icon in your browser toolbar
  2. Sign In (Optional): If you have a Maeris account, sign in to sync recordings. Otherwise, you can use it without signing in
  3. Grant Permissions: The extension may request permissions to access website data. Click "Allow" to enable full functionality
  4. You're Ready! Start recording your first test flow

Recording Your First Test Flow

Recording a test flow is simple:

  1. Navigate to Your Website: Go to the website you want to test
  2. Click the Extension Icon: Open the Light QA Assistant panel
  3. Click "Start Recording": The extension will begin capturing your interactions
  4. Interact with the Website: Click, type, navigate - do everything you want to test
  5. Stop Recording: Click "Stop Recording" when you're done
  6. Review and Export: Review the captured steps and export to Playwright
Light QA Extension recording interface

Exporting to Playwright

Once you've recorded a flow, you can export it as a Playwright script:

  1. Review Your Recording: Check all captured steps in the extension panel
  2. Click "Export": Find the export button in the extension interface
  3. Choose Format: Select either:
    • Playwright Python
    • Playwright JavaScript
    • API Collection (JSON)
  4. Download: The script will be downloaded to your computer
  5. Use in Your Project: Copy the code into your Playwright test file and run it
Exporting to Playwright from Light QA Extension

Extension Features

API and Network Tracking

Light automatically captures all network requests and API calls made during your recording:

  • Request URLs and methods (GET, POST, PUT, DELETE, etc.)
  • Request and response headers
  • Query parameters and payloads
  • Response status codes and bodies

This makes it easy to create comprehensive API test collections alongside your UI tests.

Video Recording

Optionally record your entire session as a video:

  • Perfect for debugging and sharing with your team
  • See exactly what happened during the recording
  • Helpful for documentation and training

Accessibility & GDPR Checks

Get basic compliance insights while you record:

  • WCAG accessibility issues
  • Cookie usage patterns
  • Storage and security patterns
  • GDPR compliance indicators

Troubleshooting

Extension Not Appearing

  • Check if the extension is enabled in your browser's extension management page
  • Try refreshing the page or restarting your browser
  • Ensure you're using a supported browser (Chrome, Edge, or Brave)

Recording Not Working

  • Make sure you've clicked "Start Recording" before interacting with the page
  • Check if the extension has the necessary permissions
  • Try reloading the page and starting a new recording

Export Not Available

  • Ensure you've stopped the recording before trying to export
  • Make sure at least one interaction was captured
  • Check your browser's download settings if the file doesn't download

Best Practices

  • Record Complete Flows: Record entire user journeys from start to finish for comprehensive test coverage
  • Use Stable Selectors: Light generates stable selectors automatically, but review them before exporting
  • Organize Your Recordings: Give your recordings descriptive names to easily identify them later
  • Test the Exported Code: Always test the exported Playwright script to ensure it works correctly
  • Combine with Maeris Terminal: Use Light for recording and Terminal for quick test iterations

Next Steps

Now that you have Light QA Extension installed: