Course contentsShow
← Software Engineering
Lesson 572 of 1,93317. End-to-End and UI TestingFree lesson

Stable Selector Strategies

Learn to use data-testid attributes and stable selectors instead of brittle CSS classes or text content for element location.

Stable Selector Strategies

What you'll learn: How to locate UI elements in tests using stable, reliable identifiers that won't break when styling or text changes.

Why Selectors Break

In the previous lesson, you learned that E2E tests are fragile. One major culprit is brittle selectors—the way your tests locate elements on the page. If you select elements by CSS class names like .btn-primary or text content like "Submit", your tests break whenever designers tweak styles or copywriters change button text. These identifiers change frequently and weren't designed for testing.

The Stable Selector Solution

Instead of relying on implementation details, use semantic, test-specific attributes like data-testid. These are explicit markers added to your HTML specifically for testing purposes:

<!-- Fragile: relies on CSS class -->
<button class="btn-primary">Submit Form</button>

<!-- Stable: dedicated test identifier -->
<button class="btn-primary" data-testid="submit-form-button">Submit Form</button>

When your test locates elements by data-testid="submit-form-button", it doesn't care if the class changes to .btn-blue or the text changes to "Send"—the test keeps working.

Think of It Like House Numbers

Imagine giving directions to your house. You could say "the blue house with the red door"—but if you repaint, those directions fail. A house number (like data-testid) stays the same regardless of cosmetic changes. It's a stable contract between your UI and your tests.

Best Practices

  • Use descriptive, unique data-testid values
  • Avoid selecting by CSS classes, tag names, or position whenever possible
  • Reserve text-based selectors only for critical user-facing content that must not change
  • Treat data-testid attributes as part of your testing API

Key Takeaway: Use dedicated test attributes like data-testid instead of CSS classes or text content to create selectors that survive UI changes and keep your E2E tests stable.