Spectara

About

Smart Selenium Locator Generator is a Chrome extension built for QA Automation Engineers and SDETs who are tired of writing locators by hand.

Click any element on any webpage and instantly receive:
• Five locator strategies (ID, Name, CSS Selector, Absolute XPath, Relative XPath)
• A "Best Locator" pick, ranked by stability — dynamic IDs and framework-generated classes are automatically skipped
• A ready-to-paste Selenium Java snippet
• A complete Page Object Model class generated from the URL slug
• A List<WebElement> collection locator when the element is part of a repeating list
• Full iframe support — generated code includes driver.switchTo().frame(...) chains automatically

──────────────────────────────────────
KEY FEATURES
──────────────────────────────────────

ONE-CLICK CAPTURE
Press Start Inspect. Click any element. Done.

SMART LOCATOR RANKING
The extension scans every candidate locator on the element and skips the ones that look unstable: pure-digit IDs, long hex hashes, framework prefixes (ng-, sc-, react-fb-, ember-), and CSS chains with brittle :nth-of-type calls.

AUTO-PROMOTE
Clicking on a decorative SVG, icon, or empty span automatically promotes the selection to the nearest actionable parent (button, link, input). Hold Alt to disable.

MULTI-CAPTURE MODE
Click multiple elements in one inspect session. The extension builds a complete POM class with all fields and methods — no copy-paste assembly.

LIST DETECTION
Click any item in a table, dropdown, menu, or product grid. The extension detects sibling patterns and generates a List<WebElement> locator plus an iteration snippet.

PAUSE MODE (P key)
Some elements only exist after a hover or click opens a popup (dropdowns, tooltips, custom menus). Pause mode disables capture so you can interact with the page naturally, then resumes when you press P again.

IFRAME SUPPORT
Same-origin and cross-origin iframes are supported through Chrome's per-frame content script model. Generated Java and POM code includes driver.switchTo().frame() chains so your tests work out of the box.

SHADOW DOM SUPPORT
Open shadow roots are traversed via chained host.shadowRoot walks. Generated code uses Selenium 4.4+ WebElement.getShadowRoot() + SearchContext.findElement for clean cross-shadow access.

MODERN, ISOLATED UI
The in-page status panel runs inside a Shadow DOM root, so site CSS cannot break our overlay and our crosshair cursor cannot bleed into your page. The popup uses macOS Tahoe-inspired liquid-glass styling with dark and light themes.

OS-AWARE KEYBOARD HINTS
Shows ⌥ Option on macOS and Alt on Windows / Linux — small detail, big polish.

KEYBOARD SHORTCUTS
• Ctrl/Cmd + Shift + L — open the extension
• Alt + click — capture exact element (no auto-promote)
• P — pause / resume inspect
• Esc — cancel inspect

──────────────────────────────────────
PRO TIER (OPTIONAL)
──────────────────────────────────────

The core extension is free and open source — all features above are included. An optional Pro tier ($4.99/mo) adds:

• Playwright TypeScript + Python codegen
• Export full POM as .java file
• Live locator validation (uniqueness + match count on the live page)
• Cypress codegen (coming soon)
• Cloud sync of captures across devices (coming soon)

──────────────────────────────────────
WHO IT'S FOR
──────────────────────────────────────

• QA Automation Engineers writing Selenium tests in Java
• SDETs building Page Object Model frameworks
• QA Leads onboarding junior engineers
• Anyone who has ever written /div[3]/div[2]/span[1] and felt bad about it

──────────────────────────────────────
PRIVACY & SECURITY
──────────────────────────────────────

This extension:
• Does NOT collect, transmit, or sell any user data
• Does NOT use analytics, telemetry, or fingerprinting
• Stores all captures locally in chrome.storage.local
• Is fully open source on GitHub (MIT license)
• Works completely offline for free users
• Pro users only: sends one license-validation request per 24 hours to api.smartselenium.dev (license key only — no captures, no element data)

──────────────────────────────────────
OPEN SOURCE
──────────────────────────────────────

MIT licensed. Source code, issues, and contributions welcome:
https://github.com/abdelrahmant-9/smart-selenium-locator-generator

──────────────────────────────────────
SUPPORT
──────────────────────────────────────

• Email: [email protected]
• GitHub Issues: https://github.com/abdelrahmant-9/smart-selenium-locator-generator/issues

Built by a QA Automation Engineer for QA Automation Engineers.