DEV Community

Cover image for How We Eliminated 90% of Our Locator Failures Using Value Transformations with XPathy
Volta Jebaprashanth
Volta Jebaprashanth

Posted on

How We Eliminated 90% of Our Locator Failures Using Value Transformations with XPathy

#testing #automation #tooling #java

The promise of automated testing is speed and reliability. The reality, however, often involves staring at a CI pipeline failure caused by a tiny, heartbreaking UI change — a change that turns "Submit Button" into "submit button".

This minor inconsistency is the source of endless locator flakiness. Our team realized that the problem wasn’t the XPath syntax itself — it was the fragile, exact-match relationship between our code and the messy, dynamic reality of the browser’s DOM.

By implementing Value Transformations using the Java library XPathy, we stopped fighting minor UI changes and started building resilient locators. The result? A measured 90% reduction in locator-related pipeline failures over three months.

Here’s how we achieved that transformation.

1. The Real Enemy: Dynamic Noise

Most locator failures aren't caused by a complete restructuring of the HTML; they’re caused by “noise”:

  • Case Inconsistency: New York vs NEW YORK
  • Unwanted Whitespace: Extra spaces, tabs, or newlines in text content — e.g., " Log In "
  • Formatting Characters: Currency symbols, commas, or parentheses in numeric values — e.g., ($1,234.56)

Traditional XPath solutions require manually embedding complex functions like translate() or normalize-space(), making locators unreadable and still prone to string errors.

2. The Transformation Toolkit

XPathy replaces manual function transcription with declarative, fluent methods. These automatically wrap your target value in robust XPath code, normalizing the element’s content before comparison.

A. Case-Agnostic Comparison

We stopped worrying about whether a button’s text was capitalized. This immediately fixed all failures related to localization and internal styling changes.

Traditional, Brittle XPath XPathy, Resilient Code
//button[text()='Login'] button.byText().withCase(IGNORED).equals("login")

Resulting Robust XPath:

//button[translate(text(), 'ABCDEFGHIJKLMNOPQRSTUVWXYZ', 'abcdefghijklmnopqrstuvwxyz')='login']
Enter fullscreen mode Exit fullscreen mode

B. Whitespace Normalization

Whitespace is the silent killer. Dynamic content often carries unintended leading or trailing spaces. The .withNormalizeSpace() transformation ensures only meaningful characters are compared.

// Stops a test from failing if the text is "  Order Confirmed  "
XPathy locator = div.byText().withNormalizeSpace().equals("Order Confirmed");
Enter fullscreen mode Exit fullscreen mode

Resulting Robust XPath:

//div[normalize-space(text())='Order Confirmed']
Enter fullscreen mode Exit fullscreen mode

C. Filtering Out the Noise

When validating numeric values (prices, scores, counts), you often need to ignore symbols and formatting. XPathy lets you remove characters before comparison.


// Check a price div that might contain "$1,999.00"
XPathy locator = div.byAttribute(class_).equals("total")
                     .and()
                     .byText().withRemoveOnly(CURRENCY_SYMBOLS, COMMAS).equals("1999.00");

// The result removes '$' and ',' before comparing against the expected value.
Enter fullscreen mode Exit fullscreen mode

3. The Tangible Business Result

By adopting Value Transformations, we shifted our focus from low-value maintenance to high-value feature testing.

  • ✅ 90% Reduction in Locator Flakiness: Tests became stable across environments (staging vs. production) because minor formatting differences no longer broke them.
  • ⚡ Faster Authoring: Engineers stopped researching complex XPath functions and simply declared intent.
  • 🧩 Clearer Code: Fluent syntax like .withCase(IGNORED) instantly communicates intent, simplifying code reviews and onboarding.

XPathy provides a lot more: Read the Full Documentation:

https://dev.to/volta_jebaprashanth_ac7af/xpathy-a-fluent-api-for-writing-smarter-cleaner-xpath-in-selenium-5753

The Repository:

https://github.com/Volta-Jebaprashanth/xpathy

We discovered that resilience isn’t about avoiding change — it’s about embracing it by making locators immune to tiny, inevitable inconsistencies of web development.

If you’re tired of watching your CI pipeline go red because of a stray space or capitalization difference, it’s time to equip your team with XPathy’s Value Transformations.

Reliability is within reach.

Top comments (0)