Find element by class name in Selenium Python - Framework Patterns

Framework Mode - Find element by class name

Folder Structure

selenium_project/
├── src/
│   ├── pages/
│   │   └── home_page.py          # Page Object for Home page
│   ├── tests/
│   │   └── test_home.py          # Test cases
│   ├── utils/
│   │   └── helpers.py            # Utility functions
│   └── config/
│       └── config.py             # Configuration settings
├── requirements.txt
└── pytest.ini                    # Pytest configuration
    

Test Framework Layers

• Driver Layer: Manages browser setup and teardown using Selenium WebDriver.
• Page Objects: Classes representing pages, with methods to find elements by class name and interact with them.
• Tests: Test functions or classes that use page objects to perform actions and assertions.
• Utilities: Helper functions for common tasks like waits or logging.
• Configuration: Central place for environment variables, browser options, and credentials.

Configuration Patterns

Use a config.py file to store settings like:

• Base URL of the application
• Browser choice (e.g., Chrome, Firefox)
• Timeouts for waits
• Credentials (use environment variables or secure vaults for sensitive data)

Example snippet from config.py:

import os

BASE_URL = "https://example.com"
BROWSER = "chrome"
IMPLICIT_WAIT = 10
USERNAME = os.getenv("APP_USERNAME")
PASSWORD = os.getenv("APP_PASSWORD")

Test Reporting and CI/CD Integration

• Use pytest with plugins like pytest-html for readable HTML reports.
• Integrate tests in CI/CD pipelines (GitHub Actions, Jenkins) to run on each code push.
• Configure reports to show pass/fail status and screenshots on failure.
• Use logs to help debug element finding issues, especially with class name selectors.

Best Practices

• Use Page Object Model to separate element locators and test logic.
• Prefer explicit waits over implicit waits to wait for elements by class name.
• Use descriptive class names in locators to avoid brittle tests.
• Handle cases where multiple elements share the same class by using find_elements and indexing.
• Keep locators in one place (page objects) to ease maintenance.

Self Check

Where in this folder structure would you add a new method to find an element by class name on the Login page?

Key Result

Organize Selenium Python tests using Page Objects with class name locators, explicit waits, and clear config for maintainability.

Practice

1. What does the Selenium method find_element(By.CLASS_NAME, "example") do?

easy

A. Finds elements by their ID "example".

B. Finds all elements with the class name "example" on the webpage.

C. Finds elements by their tag name "example".

D. Finds the first element with the class name "example" on the webpage.

Solution

1. Step 1: Understand the method purpose

   The method find_element locates a single element on the page.

2. Step 2: Identify the locator type

   Using By.CLASS_NAME means it looks for the first element with the given class name.

3. Final Answer:

   Finds the first element with the class name "example" on the webpage. -> Option D

4. Quick Check:

   find_element + CLASS_NAME = first matching element [OK]

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

Common Mistakes:

• Confusing find_element with find_elements (plural)
• Using class name but expecting multiple elements
• Mixing class name with ID or tag name locators

2. Which of the following is the correct syntax to find an element by class name "btn-primary" using Selenium in Python?

easy

A. driver.find_element(By.CLASS_NAME, "btn-primary")

B. driver.find_element_by_class_name("btn-primary")

C. driver.find_element(By.CLASS, "btn-primary")

D. driver.find_element(By.CLASSNAME, "btn-primary")

Solution

1. Step 1: Recall the correct Selenium syntax

   In Selenium Python 4+, the recommended syntax is find_element(By.CLASS_NAME, "class").

2. Step 2: Check each option for correctness

   driver.find_element(By.CLASS_NAME, "btn-primary") uses the correct locator By.CLASS_NAME and method find_element. Others use deprecated or incorrect locators.

3. Final Answer:

   driver.find_element(By.CLASS_NAME, "btn-primary") -> Option A

4. Quick Check:

   Use By.CLASS_NAME with find_element [OK]

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

Common Mistakes:

• Using deprecated find_element_by_class_name method
• Wrong locator names like CLASS or CLASSNAME
• Missing quotes around class name string

3. Given the HTML snippet:

<div class="alert success">Success!</div>
<div class="alert error">Error!</div>

What text will this Selenium Python code print?

element = driver.find_element(By.CLASS_NAME, "alert")
print(element.text)

medium

A. "Success!"

B. "Error!"

C. "Success! Error!"

D. Throws NoSuchElementException

Solution

1. Step 1: Understand find_element behavior

   It finds the first element matching the class name "alert" in the HTML order.

2. Step 2: Identify the first matching element

   The first <div> with class "alert success" contains text "Success!".

3. Final Answer:

   "Success!" -> Option A

4. Quick Check:

   find_element returns first matching element's text [OK]

Hint: find_element returns first match only, so text is from first element [OK]

Common Mistakes:

• Assuming it returns all matching elements' text
• Confusing class names with multiple classes
• Expecting an error if multiple classes exist

4. What is wrong with this Selenium Python code snippet?

element = driver.find_element(By.CLASS_NAME, ".button")

medium

A. find_element should be find_elements to find class

B. Class name should not include the dot prefix "."

C. By.CLASS_NAME is not a valid locator

D. The class name must be uppercase

Solution

1. Step 1: Check the class name format

   When using By.CLASS_NAME, the class name should be given without any CSS selector symbols like ".".

2. Step 2: Identify the error in the code

   The code incorrectly includes a dot prefix ".button" which causes a failure to find the element.

3. Final Answer:

   Class name should not include the dot prefix "." -> Option B

4. Quick Check:

   Class name locator needs plain class name, no dot [OK]

Hint: Remove dot prefix when using By.CLASS_NAME locator [OK]

Common Mistakes:

• Adding dot prefix like CSS selectors to class name
• Using find_elements when only one element is needed
• Assuming class names must be uppercase

5. You want to click the first button with class "submit-btn" on a page. Which code snippet correctly finds and clicks it using Selenium Python?

hard

A. button = driver.find_elements(By.CLASS_NAME, "submit-btn")
button.click()

B. button = driver.find_element(By.ID, "submit-btn")
button.click()

C. button = driver.find_element(By.CLASS_NAME, "submit-btn")
button.click()

D. button = driver.find_element(By.CLASS_NAME, ".submit-btn")
button.click()

Solution

1. Step 1: Choose correct method to find single element by class

   Use find_element(By.CLASS_NAME, "submit-btn") to get the first matching element.

2. Step 2: Call click() on the found element

   After locating the element, call click() to perform the click action.

3. Final Answer:

   button = driver.find_element(By.CLASS_NAME, "submit-btn")\nbutton.click() -> Option C

4. Quick Check:

   find_element + CLASS_NAME + click() = correct usage [OK]

Hint: Use find_element with class name, then call click() on it [OK]

Common Mistakes:

• Using find_elements returns list, cannot call click() directly
• Using ID locator instead of class name
• Including dot prefix in class name