Find element by XPath in Selenium Python

Introduction

We use XPath to find elements on a web page when other methods like ID or class name are not enough or available.

When the element has no unique ID or class.

When you want to find elements based on their position or text.

When you need to navigate complex HTML structures.

When testing dynamic web pages where element attributes change.

When you want to find elements with specific attribute values.

Syntax

Selenium Python

element = driver.find_element(By.XPATH, 'xpath_expression')

Use By.XPATH to specify you want to find by XPath.

The xpath_expression is a string that describes the path to the element.

Examples

Finds a button element with the ID 'submit'.

Selenium Python

element = driver.find_element(By.XPATH, '//button[@id="submit"]')

Finds a div element that contains the exact text 'Welcome'.

Selenium Python

element = driver.find_element(By.XPATH, '//div[text()="Welcome"]')

Finds an input element with type 'text' and name 'username'.

Selenium Python

element = driver.find_element(By.XPATH, '//input[@type="text" and @name="username"]')

Sample Program

This script opens a simple page with a button, finds the button using XPath, prints its text, and closes the browser.

Selenium Python

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

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

# Open a simple test page
html = '''<html><body><button id="submit">Submit</button></body></html>'''

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

# Find the button by XPath
button = driver.find_element(By.XPATH, '//button[@id="submit"]')

# Print the button text
print(button.text)

# Close the browser
driver.quit()

Important Notes

XPath expressions can be absolute (starting from root) or relative (starting from anywhere).

Using XPath can be slower than other locators, so use it only when needed.

Always test your XPath in browser DevTools before using it in code.

Summary

XPath helps find elements when other locators are not enough.

Use driver.find_element(By.XPATH, 'xpath') to find one element.

Test XPath expressions carefully to avoid errors.

Practice

1. What does the following Selenium Python code do?
driver.find_element(By.XPATH, "//button[@id='submit']")

easy

A. Finds the button element by its class name 'submit'

B. Finds all button elements with id 'submit' on the page

C. Clicks the button with id 'submit'

D. Finds the first button element with id 'submit' on the page

Solution

1. Step 1: Understand the method used

   The method find_element returns the first matching element found by the locator.

2. Step 2: Analyze the XPath expression

   The XPath //button[@id='submit'] selects button elements with attribute id='submit'.

3. Final Answer:

   Finds the first button element with id 'submit' on the page -> Option D

4. Quick Check:

   find_element + XPath with id attribute = first matching element [OK]

Hint: find_element finds only the first matching element [OK]

Common Mistakes:

• Confusing find_element with find_elements
• Thinking XPath finds by class instead of id
• Assuming it clicks the element automatically

2. Which of the following is the correct syntax to find an element by XPath in Selenium Python?

easy

A. driver.find_element(By.XPATH, "//div[@class='header']")

B. driver.find_element_by_xpath("//div[@class='header']")

C. driver.find_element(By.CSS_SELECTOR, "//div[@class='header']")

D. driver.find_element(By.ID, "//div[@class='header']")

Solution

1. Step 1: Recall the modern Selenium syntax

   Since Selenium 4, the recommended way is driver.find_element(By.XPATH, xpath_string).

2. Step 2: Check each option

   driver.find_element(By.XPATH, "//div[@class='header']") uses the correct syntax. driver.find_element_by_xpath("//div[@class='header']") is deprecated. Options C and D use wrong locator types for XPath.

3. Final Answer:

   driver.find_element(By.XPATH, "//div[@class='header']") -> Option A

4. Quick Check:

   Use By.XPATH with find_element [OK]

Hint: Use By.XPATH with find_element, not deprecated methods [OK]

Common Mistakes:

• Using deprecated find_element_by_xpath method
• Mixing locator types like CSS_SELECTOR with XPath
• Passing XPath as ID locator

3. What will be the output of this code snippet if the page contains exactly one <input name='search'> element?

element = driver.find_element(By.XPATH, "//input[@name='search']")
print(element.tag_name)

medium

A. input

B. search

C. NoSuchElementException

D. button

Solution

1. Step 1: Understand what find_element returns

   It returns the first matching WebElement for the XPath.

2. Step 2: Check the tag_name property

   The element found is an input tag, so element.tag_name returns "input".

3. Final Answer:

   input -> Option A

4. Quick Check:

   XPath finds input element, tag_name returns 'input' [OK]

Hint: tag_name returns the HTML tag of the found element [OK]

Common Mistakes:

• Confusing attribute value with tag name
• Expecting exception when element exists
• Assuming tag_name returns attribute value

4. What is wrong with this code snippet?

element = driver.find_element(By.XPATH, "//div[@class='content']")
print(element.text)

Assume the page has multiple <div class='content'> elements.

medium

A. It will raise NoSuchElementException

B. It only finds the first matching element, ignoring others

C. XPath syntax is incorrect

D. element.text will return None

Solution

1. Step 1: Understand find_element behavior

   find_element returns only the first matching element, even if multiple exist.

2. Step 2: Analyze the impact

   If multiple div.content exist, only the first is found and printed, others ignored.

3. Final Answer:

   It only finds the first matching element, ignoring others -> Option B

4. Quick Check:

   find_element returns first match only [OK]

Hint: Use find_elements to get all matches, find_element gets first only [OK]

Common Mistakes:

• Expecting find_element to return all matches
• Thinking XPath syntax is wrong
• Assuming element.text returns None if multiple elements exist

5. You want to find a button element with text exactly 'Submit' using XPath in Selenium Python. Which XPath expression is correct to use with driver.find_element(By.XPATH, xpath)?

hard

A. //button[text()!='Submit']

B. //button[contains(text(), 'Submit')]

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

D. //button[@text='Submit']

Solution

1. Step 1: Understand XPath text() function

   XPath text()='Submit' matches elements whose text content is exactly 'Submit'.

2. Step 2: Evaluate each option

   //button[text()='Submit'] matches exact text. //button[contains(text(), 'Submit')] matches partial text (not exact). //button[@text='Submit'] is invalid because text is not an attribute. //button[text()!='Submit'] matches elements whose text is not 'Submit'.

3. Final Answer:

   //button[text()='Submit'] -> Option C

4. Quick Check:

   Use text()='value' for exact text match in XPath [OK]

Hint: Use text()='value' for exact text match in XPath [OK]

Common Mistakes:

• Using @text instead of text() function
• Using contains() when exact match needed
• Using != in XPath for positive match