Finding multiple elements in Selenium Python - Framework Patterns

Framework Mode - Finding multiple elements

Folder Structure

selenium-python-project/
├── tests/
│   ├── test_example.py
│   └── test_elements.py
├── pages/
│   ├── base_page.py
│   └── elements_page.py
├── utils/
│   ├── driver_factory.py
│   └── helpers.py
├── config/
│   └── config.yaml
├── reports/
│   └── test_report.html
└── conftest.py
    

Test Framework Layers

• Driver Layer: Manages browser setup and teardown (e.g., driver_factory.py).
• Page Objects: Encapsulate page elements and actions (e.g., elements_page.py with methods to find multiple elements).
• Tests: Test scripts that use page objects to perform actions and assertions (e.g., test_elements.py).
• Utilities: Helper functions for common tasks like waits or data handling (helpers.py).
• Configuration: Environment settings, URLs, credentials stored in config.yaml.

Configuration Patterns

Use a YAML file (config/config.yaml) to store environment URLs, browser types, and credentials. Load this config in conftest.py to provide fixtures for tests.

# Example config.yaml
base_url: "https://example.com"
browser: "chrome"
credentials:
  username: "testuser"
  password: "password123"
    

Use fixtures in conftest.py to initialize WebDriver based on config and clean up after tests.

Test Reporting and CI/CD Integration

• Use pytest with pytest-html plugin to generate HTML reports saved in reports/.
• Integrate tests in CI pipelines (e.g., GitHub Actions) to run on every push or pull request.
• Failing tests highlight issues with element finding or page behavior.

Best Practices

• Use Page Object Model: Keep element locators and methods in page classes to avoid duplication.
• Use explicit waits: Wait for elements to be present before finding multiple elements to avoid flaky tests.
• Use descriptive locators: Prefer CSS selectors or XPath that clearly identify groups of elements.
• Return lists of WebElements: Methods finding multiple elements should return lists for easy iteration and assertions.
• Keep tests simple: Tests should call page methods and assert expected counts or properties of multiple elements.

Self Check

Where in this folder structure would you add a new method to find all buttons on a page?

Key Result

Organize Selenium Python tests using Page Object Model with clear layers for driver, pages, tests, utilities, and config to find multiple elements reliably.

Practice

1. What does the find_elements method in Selenium Python return when used to locate multiple elements?

easy

A. A list of WebElement objects matching the locator

B. A single WebElement object

C. A boolean indicating if elements exist

D. An integer count of elements found

Solution

1. Step 1: Understand the purpose of find_elements

   This method is designed to find all elements matching a locator, not just one.

2. Step 2: Identify the return type

   It returns a list of WebElement objects, even if the list is empty when no elements match.

3. Final Answer:

   A list of WebElement objects matching the locator -> Option A

4. Quick Check:

   find_elements returns list [OK]

Hint: Remember: plural 'elements' means a list, not one item [OK]

Common Mistakes:

• Confusing find_element (single) with find_elements (multiple)
• Expecting a single WebElement instead of a list
• Thinking it returns a count or boolean

2. Which of the following is the correct syntax to find all buttons on a page using Selenium Python?

easy

A. driver.find_elements(By.TAG_NAME, 'button')

B. driver.find_element(By.TAG_NAME, 'button')

C. driver.find_elements('button')

D. driver.find_element('button')

Solution

1. Step 1: Use the correct method for multiple elements

   To find all buttons, use find_elements, not find_element.

2. Step 2: Use the correct locator syntax

   The method requires two arguments: locator strategy and locator value, e.g., By.TAG_NAME and 'button'.

3. Final Answer:

   driver.find_elements(By.TAG_NAME, 'button') -> Option A

4. Quick Check:

   Correct method and locator = B [OK]

Hint: Use find_elements with By strategy and locator tuple [OK]

Common Mistakes:

• Using find_element instead of find_elements
• Passing only one argument instead of two
• Using string locator without By class

3. What will be the output of this code snippet if the page has exactly 3 <li> elements?

items = driver.find_elements(By.TAG_NAME, 'li')
print(len(items))

medium

A. Error

B. 1

C. 0

D. 3

Solution

1. Step 1: Understand what find_elements returns

   It returns a list of all matching elements. Here, it finds all <li> tags.

2. Step 2: Use len() to count elements

   Since there are 3 <li> elements, len(items) returns 3.

3. Final Answer:

   3 -> Option D

4. Quick Check:

   Count of found elements = 3 [OK]

Hint: len() on find_elements list gives number found [OK]

Common Mistakes:

• Expecting find_elements to return a single element
• Confusing find_element with find_elements
• Assuming print outputs elements instead of count

4. Identify the error in this code snippet:

elements = driver.find_elements(By.CLASS_NAME)
for el in elements:
    print(el.text)

medium

A. Incorrect loop syntax

B. Using find_elements instead of find_element

C. Missing locator value argument in find_elements

D. Cannot print text of elements

Solution

1. Step 1: Check find_elements method arguments

   find_elements requires two arguments: locator strategy and locator value. Here only one is given.

2. Step 2: Understand the error cause

   Missing the second argument (the class name string) causes a TypeError.

3. Final Answer:

   Missing locator value argument in find_elements -> Option C

4. Quick Check:

   Two arguments needed for find_elements [OK]

Hint: Always provide locator type and value in find_elements [OK]

Common Mistakes:

• Passing only locator type without value
• Confusing find_element and find_elements usage
• Assuming loop syntax is wrong

5. You want to click all links inside a <div> with id 'menu'. Which code correctly finds and clicks all these links?

hard

A. links = driver.find_element(By.CSS_SELECTOR, '#menu a')
for link in links:
link.click()

B. links = driver.find_elements(By.CSS_SELECTOR, '#menu a')
for link in links:
link.click()

C. links = driver.find_elements(By.ID, 'menu a')
for link in links:
link.click()

D. links = driver.find_elements(By.CLASS_NAME, 'menu a')
for link in links:
link.click()

Solution

1. Step 1: Use correct locator for links inside #menu

   The CSS selector '#menu a' selects all <a> tags inside the element with id 'menu'.

2. Step 2: Use find_elements to get all matching links

   find_elements returns a list of all matching elements, allowing iteration.

3. Step 3: Loop through each link and click

   Iterate over the list and call click() on each WebElement.

4. Final Answer:

   links = driver.find_elements(By.CSS_SELECTOR, '#menu a') for link in links: link.click() -> Option B

5. Quick Check:

   Correct locator and method = A [OK]

Hint: Use CSS selector '#menu a' with find_elements to get all links [OK]

Common Mistakes:

• Using find_element instead of find_elements
• Wrong locator syntax for nested elements
• Using By.ID with compound selector string