XPath with text() in Selenium Python

Introduction

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

You want to click a button or link with a specific label.

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

You want to find a list item or paragraph by its visible text.

You are testing a page where element IDs or classes are dynamic but text is stable.

Syntax

Selenium Python

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

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

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

Examples

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

Selenium Python

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

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

Selenium Python

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

Selects a paragraph with the exact welcome message.

Selenium Python

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

Sample Program

This script opens a simple HTML page with buttons, a link, and a paragraph. It uses XPath with text() to find elements by their visible text and prints their text content.

Selenium Python

from selenium import webdriver
from selenium.webdriver.common.by import By

# Setup WebDriver (make sure driver executable is in PATH)
driver = webdriver.Chrome()

# Open a simple test page
html = '''
<html>
  <body>
    <button>Submit</button>
    <button>Cancel</button>
    <a href='#'>Home</a>
    <p>Welcome to our site!</p>
  </body>
</html>
'''

# Load the HTML content using data URL
driver.get('data:text/html;charset=utf-8,' + html)

# Find the Submit button using XPath with text()
submit_button = driver.find_element(By.XPATH, "//button[text()='Submit']")
print('Submit button text:', submit_button.text)

# Find the Home link
home_link = driver.find_element(By.XPATH, "//a[text()='Home']")
print('Home link text:', home_link.text)

# Find the paragraph
welcome_para = driver.find_element(By.XPATH, "//p[text()='Welcome to our site!']")
print('Paragraph text:', welcome_para.text)

# Close the browser
driver.quit()

Important Notes

Text matching with text() is exact. Use functions like contains() if partial matching is needed.

Whitespace and case must match exactly when using text().

Using text() is helpful when element attributes are not reliable or missing.

Summary

XPath with text() finds elements by their exact visible text.

It is useful for buttons, links, and messages where text is stable.

Remember to match text exactly, including spaces and case.

Practice

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

easy

A. A button element containing the word 'Submit' anywhere inside

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

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

D. All buttons regardless of their text

Solution

1. Step 1: Understand the XPath syntax

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

2. Step 2: Analyze the text() condition

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

3. Final Answer:

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

4. Quick Check:

   XPath with text() matches exact visible text [OK]

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

Common Mistakes:

• Confusing attribute matching with text()
• Assuming partial text matches work
• Ignoring case sensitivity in text()

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

easy

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

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

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

D. //a[text() = Home]

Solution

1. Step 1: Check the correct use of text() function

   The correct syntax to match exact text is text()='Home' inside square brackets.

2. Step 2: Identify syntax errors in other options

   //a[contains(text(), 'Home')] uses contains() which matches partial text, not exact. //a[@text='Home'] incorrectly treats text as an attribute. //a[text() = Home] misses quotes around 'Home'.

3. Final Answer:

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

4. Quick Check:

   Exact text match requires text()='value' with quotes [OK]

Hint: Exact text match uses text()='value' with quotes [OK]

Common Mistakes:

• Using contains() instead of text() for exact match
• Treating text as an attribute
• Missing quotes around text value

3. Given the following HTML snippet:

<div>
  <span>Login</span>
  <span>Logout</span>
  <span>Login</span>
</div>

What will be the result of this Selenium Python code?

elements = driver.find_elements(By.XPATH, "//span[text()='Login']")
print(len(elements))

medium

A. 2

B. 1

C. 3

D. 0

Solution

1. Step 1: Identify elements matching XPath

   The XPath //span[text()='Login'] selects all <span> elements with exact text 'Login'. There are two such spans in the HTML.

2. Step 2: Count the matched elements

   The find_elements method returns a list of matching elements. Its length is 2.

3. Final Answer:

   2 -> Option A

4. Quick Check:

   Count of spans with text 'Login' = 2 [OK]

Hint: Count elements with exact text using find_elements and len() [OK]

Common Mistakes:

• Assuming only one element matches
• Confusing find_element with find_elements
• Ignoring exact text match requirement

4. You wrote this XPath to find a button with text 'Cancel': //button[text()='Cancel']. But your test fails to find the button. What is the most likely reason?

medium

A. The button text has extra spaces or different case

B. The XPath syntax is invalid

C. The button element does not exist on the page

D. The text() function matches partial text only

Solution

1. Step 1: Check XPath syntax correctness

   The XPath //button[text()='Cancel'] is syntactically correct, so syntax error is unlikely.

2. Step 2: Consider text matching behavior

   The text() function matches exact visible text including spaces and case. If the button text has extra spaces or different case (e.g., ' cancel ' or 'CANCEL'), it won't match.

3. Final Answer:

   The button text has extra spaces or different case -> Option A

4. Quick Check:

   Exact text match fails if spaces or case differ [OK]

Hint: Check exact text including spaces and case for text() [OK]

Common Mistakes:

• Assuming text() matches partial or case-insensitive text
• Ignoring leading/trailing spaces in text
• Blaming XPath syntax without checking text content

5. You want to select a <div> element that contains exactly the text 'Error: Invalid input' but the text may have leading or trailing spaces. Which XPath expression correctly handles this using text() and normalize-space()?

hard

A. //div[normalize-space()='Error: Invalid input']

B. //div[text()='Error: Invalid input']

C. //div[contains(text(), 'Error: Invalid input')]

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

Solution

1. Step 1: Understand the problem with spaces

   Text may have extra spaces, so exact text()='Error: Invalid input' won't match if spaces differ.

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

   normalize-space(text()) removes leading and trailing spaces before comparison, ensuring correct match.

3. Step 3: Evaluate options

   //div[text()='Error: Invalid input'] fails if spaces differ. //div[contains(text(), 'Error: Invalid input')] matches partial text, not exact. //div[normalize-space()='Error: Invalid input'] uses normalize-space() without text(), which may fail if element has multiple text nodes.

4. Final Answer:

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

5. Quick Check:

   Use normalize-space(text()) for exact text ignoring spaces [OK]

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

Common Mistakes:

• Not trimming spaces before text comparison
• Using contains() for exact match
• Applying normalize-space() incorrectly