XPath with text() in Selenium Java

Introduction

XPath with text() helps find elements by matching their visible text. It makes locating elements easier when you know the exact text shown on the page.

You want to click a button with a specific label like 'Submit'.

You need to verify that a message with exact text appears on the page.

You want to find a link by its visible text to navigate somewhere.

You want to check if a warning or error message with certain text is displayed.

Syntax

Selenium Java

//tagname[text()='exact text']

Replace tagname with the HTML element name like button or a.

The text inside text()='...' must match exactly, including spaces and case.

Examples

Selects a button element whose visible text is exactly 'Submit'.

Selenium Java

//button[text()='Submit']

Selects a link (a) with the text 'Home'.

Selenium Java

//a[text()='Home']

Selects a div element with the exact text 'Welcome to our site!'.

Selenium Java

//div[text()='Welcome to our site!']

Sample Program

This test opens a webpage, finds a button with the exact text 'Submit' using XPath with text(), and prints if it is visible.

Selenium Java

import org.openqa.selenium.By;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.WebElement;
import org.openqa.selenium.chrome.ChromeDriver;

public class XPathTextExample {
    public static void main(String[] args) {
        System.setProperty("webdriver.chrome.driver", "path/to/chromedriver");
        WebDriver driver = new ChromeDriver();
        try {
            driver.get("https://example.com/testpage");

            // Find button with text 'Submit'
            WebElement submitButton = driver.findElement(By.xpath("//button[text()='Submit']"));

            // Check if button is displayed
            if (submitButton.isDisplayed()) {
                System.out.println("Submit button found and visible.");
            } else {
                System.out.println("Submit button not visible.");
            }

        } finally {
            driver.quit();
        }
    }
}

Important Notes

Text matching with text() is exact. Extra spaces or different case will cause no match.

Use contains(text(), 'partial text') if you want to match part of the text.

Always prefer unique text to avoid selecting multiple elements accidentally.

Summary

XPath with text() helps find elements by their visible text.

It requires exact text match unless using contains().

Useful for buttons, links, messages, and labels with known text.

Practice

1. What does the XPath expression //button[text()='Submit'] select in a web page?

easy

A. A button element with the exact visible text 'Submit'

B. Any element with the attribute text='Submit'

C. All buttons regardless of their text

D. Any element containing the word 'Submit' anywhere

Solution

1. Step 1: Understand the XPath syntax

   The expression //button selects all button elements in the document.

2. Step 2: Apply the text() condition

   The predicate [text()='Submit'] filters those buttons to only those whose visible text exactly matches 'Submit'.

3. Final Answer:

   A button element with the exact visible text 'Submit' -> Option A

4. Quick Check:

   XPath with text() = exact text match [OK]

Hint: Use text() for exact visible text match in XPath [OK]

Common Mistakes:

• Confusing attribute text with text() function
• Assuming partial text match without contains()
• Selecting wrong element types

2. Which of the following is the correct XPath syntax to select a link (<a>) with visible text exactly 'Home'?

easy

A. //a[text()='Home']

B. //a[contains(text(), 'Home')]

C. //a[text()='home']

D. //a[@text='Home']

Solution

1. Step 1: Identify exact text match syntax

   The correct syntax for exact text match uses text()='Home' inside brackets.

2. Step 2: Check each option

   //a[contains(text(), 'Home')] uses contains(), which is partial match, not exact. //a[text()='home'] has wrong case 'home' (case-sensitive). //a[@text='Home'] incorrectly treats text as attribute.

3. Final Answer:

   //a[text()='Home'] -> Option A

4. Quick Check:

   Exact text match uses text()='value' [OK]

Hint: Use text()='ExactText' for precise text matching [OK]

Common Mistakes:

• Using contains() when exact match is needed
• Ignoring case sensitivity in text()
• Treating text as an attribute

3. Given the following HTML snippet:

<div>
  <button>Save</button>
  <button>Cancel</button>
  <button>Save As</button>
</div>

What will the XPath //button[text()='Save'] select?

medium

A. All three buttons

B. Both buttons with texts 'Save' and 'Save As'

C. No buttons because 'Save' is part of 'Save As'

D. The first button with text 'Save' only

Solution

1. Step 1: Understand exact text() matching

   The XPath text()='Save' matches only buttons whose visible text is exactly 'Save'.

2. Step 2: Analyze the buttons' text

   Only the first button has exactly 'Save'. The third button's text is 'Save As', which does not match exactly.

3. Final Answer:

   The first button with text 'Save' only -> Option D

4. Quick Check:

   text()='Save' matches exact text only [OK]

Hint: Exact text() matches full text, not partial [OK]

Common Mistakes:

• Assuming partial match with text()
• Selecting multiple elements incorrectly
• Ignoring spaces or extra words

4. You wrote this XPath to select a label with text 'Username': //label[text()='username']. It does not find the element. What is the likely problem?

medium

A. Missing contains() function for partial match

B. XPath is case-sensitive; 'username' does not match 'Username'

C. text() cannot be used with label elements

D. XPath syntax requires @text attribute instead of text()

Solution

1. Step 1: Check case sensitivity in XPath text()

   XPath text() matching is case-sensitive, so 'username' does not match 'Username'.

2. Step 2: Verify other options

   text() works with any element, contains() is optional, and @text is invalid attribute syntax.

3. Final Answer:

   XPath is case-sensitive; 'username' does not match 'Username' -> Option B

4. Quick Check:

   XPath text() is case-sensitive [OK]

Hint: Match exact case in text() for correct XPath [OK]

Common Mistakes:

• Ignoring case sensitivity
• Using attribute syntax instead of text()
• Assuming text() only works on certain tags

5. You want to select a <span> element that contains the exact text 'Error: Invalid input' but the page sometimes adds extra spaces before or after the text. Which XPath expression is best to handle this?

hard

A. //span[text()='Error: Invalid input']

B. //span[contains(text(), 'Error: Invalid input')]

C. //span[normalize-space(text())='Error: Invalid input']

D. //span[@text='Error: Invalid input']

Solution

1. Step 1: Understand the problem with extra spaces

   Extra spaces before or after text cause exact text() match to fail.

2. Step 2: Use normalize-space() to trim spaces

   Using normalize-space(text())='Error: Invalid input' trims spaces and matches exact text.

3. Step 3: Evaluate other options

   //span[text()='Error: Invalid input'] fails with spaces, //span[contains(text(), 'Error: Invalid input')] matches partial text (not exact), //span[@text='Error: Invalid input'] is invalid syntax.

4. Final Answer:

   //span[normalize-space(text())='Error: Invalid input'] -> Option C

5. Quick Check:

   normalize-space() trims spaces for exact text match [OK]

Hint: Use normalize-space() to ignore extra spaces in text() [OK]

Common Mistakes:

• Using text() without trimming spaces
• Using contains() when exact match needed
• Treating text as attribute