Testbot Recorder

# TestBot Recorder - Browser Interaction Recording & Element Capture

> TestBot Recorder is a Chrome extension for test automation that combines browser interaction recording with intelligent element capture. Record user actions, capture web elements with auto-generated locators, and publish directly to your test management platform.

## Key Features

### Element Spy

- **Auto-Spy Mode** - Scan up to 100 interactive elements on a page with one click
- **Manual Spy Mode** - Click individual elements to capture their properties
- **Multiple Locator Strategies** - Generates locators for:
- ID
- Name
- Class Name
- XPath (absolute and relative)
- CSS Selector
- Link Text / Partial Link Text
- Tag Name
- **Locator Validation** - Real-time validation showing:
- Unique (matches exactly 1 element)
- Ambiguous (matches multiple elements)
- Invalid (no elements found)
- **Default Locator Selection** - Set preferred locator strategy per element
- **Keyboard Shortcuts** - `Ctrl+Shift+S` (Mac: `Cmd+Shift+S`) to toggle spy, `Ctrl+Shift+A` (Mac: `Cmd+Shift+A`) to auto-spy, `Ctrl+Shift+E` (Mac: `Cmd+Shift+E`) to export

### Browser Interaction Recorder

- **Smart Recording** - Automatically captures clicks, typing, selections, checkboxes, and navigation events
- **Template Matching** - Maps recorded actions to predefined test templates for consistent test generation
- **Action Consolidation** - Intelligently merges consecutive TYPE, SELECT, and CHECK/UNCHECK actions
- **Multi-Tab Support** - Handles tab switches and cross-domain navigation with user prompts
- **Screenshot Capture** - Captures full-page screenshots during recording sessions
- **Keyboard Shortcuts** - `Ctrl+Shift+R` (Mac: `Cmd+Shift+R`) to start/resume, `Ctrl+Shift+X` (Mac: `Cmd+Shift+X`) to stop

### Export & Publish

- **Download** - Export captured elements or recorded scripts as files
- **Publish** - Send directly to Test Management Services with API token authentication
- **Project Integration** - Select target project and website for organized test management

### User Interface

- **Floating Panel** - Draggable, resizable panel that stays on top of web content
- **Fullscreen Mode** - Expanded view with 3-column layout for detailed information
- **Minimized Mode** - Compact view with quick access to stop recording
- **Dark/Light Theme** - Follows system preferences

## How It Works

1. **Install & Activate**
- Add the extension to Chrome
- Press `Alt+T` or click the extension icon to open TestBot

2. **Configure (Optional)**
- Set API token for publishing to Test Management Services
- Select target project and website

3. **Record Interactions**
- Enter a script name and click "Start Recording"
- Interact with the web page - all actions are captured automatically
- Click "Stop Recording" when done

4. **Capture Elements**
- Switch to Element Spy tab
- Use "Auto-spy" to scan all elements or toggle spy mode for manual capture
- Review and validate generated locators

5. **Export or Publish**
- Download as a file for local use
- Publish directly to your test management platform

## Keyboard Shortcuts

| Action | Windows/Linux | Mac |
|--------|---------------|-----|
| Toggle TestBot | `Alt+T` | `Alt+T` |
| Toggle Spy Mode | `Ctrl+Shift+S` | `Cmd+Shift+S` |
| Auto-Spy Elements | `Ctrl+Shift+A` | `Cmd+Shift+A` |
| Export Elements | `Ctrl+Shift+E` | `Cmd+Shift+E` |
| Start/Resume Recording | `Ctrl+Shift+R` | `Cmd+Shift+R` |
| Stop Recording | `Ctrl+Shift+X` | `Cmd+Shift+X` |

## Requirements

- Google Chrome browser
- Active internet connection (for publishing features)
- API token from Test Management Services (for publishing)

---

> TestBot Recorder empowers QA engineers and developers to build automated tests faster and more accurately. Capture elements, record interactions, and integrate seamlessly with your test automation workflow.