AegisRunner Selector Recorder
A Chrome extension that lets you visually capture CSS selectors from any website — then use them directly in your AegisRunner test steps.
Works with Chrome, Edge, Brave, and other Chromium-based browsers
How It Works
Start Recording
Click the AegisRunner icon in your toolbar, then press "Start Recording". Your cursor changes to a crosshair.
Browse & Click Elements
Navigate to the website you're testing. Hover over any element to see it highlighted in cyan. Click to capture its CSS selector — it's copied to your clipboard automatically.
Import into Suite Editor
Open any test suite and click the "Extension" button next to a step's selector field. All your captured selectors appear in a picker — click one to fill it in. You can also click "Use in AegisRunner" from the extension popup to jump straight to a suite.
Features
Point & Click Capture
Hover over any element to highlight it, then click to capture the optimal CSS selector automatically.
Smart Selector Generation
Generates stable selectors using #id, [data-testid], [aria-label], tag.class, or contextual paths — in that priority order.
Auto-Copy to Clipboard
Every captured selector is instantly copied to your clipboard, ready to paste into the suite editor.
Selector History
All captured selectors are saved (up to 50) with element tag, source URL, and one-click copy.
Use in AegisRunner
Send any captured selector directly to the AegisRunner suite editor with one click.
Privacy-First
No data leaves your browser. Everything is stored locally using chrome.storage. No analytics, no tracking.
Installation
Get up and running in under a minute.
Download the extension
Click the download button to get the extension zip file.
Unzip the file
Extract the downloaded zip to a folder on your computer.
Open Chrome Extensions
Go to chrome://extensions/ in your browser and enable "Developer mode" in the top-right corner.
Load the extension
Click "Load unpacked" and select the extracted folder. The AegisRunner icon appears in your toolbar.
Selector Strategy
The extension picks the most stable, unique selector using this priority:
| Priority | Strategy | Example |
|---|---|---|
| 1 | Unique ID | #login-btn |
| 2 | data-testid attribute | [data-testid="submit"] |
| 3 | aria-label attribute | [aria-label="Close dialog"] |
| 4 | Tag + class (if unique) | button.primary-action |
| 5 | Contextual path | #sidebar > nav > a.active |
| 6 | nth-child path | div:nth-child(2) > ul > li:nth-child(3) |
Ready to speed up your test creation?
Download the Selector Recorder and start building test steps with point-and-click precision.
Download Extension