XPathy

About

XPathy Chrome Extension

The XPathy Chrome Extension is a visual companion for the XPathy Java library — a fluent API that simplifies writing XPath expressions for Selenium automation.

Instead of manually writing long and complex XPath strings, XPathy lets you build locators in a readable Java format such as:
div.byText().contains("Login").and().byAttribute(id).equals("main");

It automatically converts this to:
//div[contains(text(), 'Login') and @id='main']

The Chrome Extension brings this capability directly to your browser. You can paste your XPathy (Java) snippet, convert it instantly to a valid XPath, and highlight matching elements on any web page.

---

HOW IT WORKS

This extension connects to a lightweight local server called “XPathy Server,” which handles the code conversion. Your snippets are processed locally — nothing ever leaves your machine.

1. Download the xpathy-server.jar file from:
   https://github.com/Volta-Jebaprashanth/xpathy-server
2. Run it (requires Java 17 or higher).
3. The server runs automatically on http://localhost:5056
4. Open the extension and start converting snippets.

---

KEY FEATURES

• Convert XPathy (Java) snippets into XPath instantly
• Highlight all matching elements on the current page
• Navigate through matches using Next / Previous buttons
• Works from both the Chrome Toolbar and DevTools tab
• Offline mode — uses your local server, no network needed
• Real-time syntax validation (Run button turns red if invalid)
• Update server endpoint manually if you use a custom port

---

HOW TO USE

1. Run xpathy-server.jar
2. Open Chrome → click the XPathy icon or open DevTools → XPathy tab
3. Paste your XPathy (Java) snippet
4. Click Run to convert
5. Matching elements will be highlighted in red overlays
6. Use Next / Previous to browse matches

---

EXAMPLE

XPathy snippet:
button.byText().contains("Submit").and().byAttribute(class_).equals("primary");

Generated XPath:
//button[contains(text(), 'Submit') and @class='primary']

---

REQUIREMENTS

• Java 17 or higher
• Google Chrome (latest version)

---

TECH STACK

Frontend: HTML, CSS, JavaScript (Manifest V3)
Backend: Java (xpathy-server)
Works entirely offline and securely on your local machine.

---

PART OF THE XPATHY ECOSYSTEM

• XPathy Java Library: https://github.com/Volta-Jebaprashanth/xpathy
• XPathy Server: https://github.com/Volta-Jebaprashanth/xpathy-server
• XPathy Chrome Extension: https://github.com/Volta-Jebaprashanth/xpathy-chrome-extension

---

AUTHOR

Developed by: Volta Jebaprashanth
Email: [email protected]
LinkedIn: https://www.linkedin.com/in/voltajeba

Made with ❤️ for testers and developers who love clean, readable locators.

---

Happy Testing with XPathy!