findElements for multiple matches in Selenium Java

Introduction

We use findElements to get all web elements that match a locator. This helps when we want to work with many items on a page, not just one.

You want to check all buttons with the same class on a page.

You need to count how many links are in a menu.

You want to click each checkbox in a list.

You want to verify all error messages shown on a form.

You want to collect text from multiple similar elements.

Syntax

Selenium Java

List<WebElement> elements = driver.findElements(By.locatorType("locatorValue"));

findElements returns a list of elements, even if none are found (empty list).

Use By to specify how to find elements (id, className, xpath, cssSelector, etc.).

Examples

Finds all elements with class btn.

Selenium Java

List<WebElement> buttons = driver.findElements(By.className("btn"));

Finds all anchor (a) tags on the page.

Selenium Java

List<WebElement> links = driver.findElements(By.tagName("a"));

Finds all list items inside unordered lists.

Selenium Java

List<WebElement> items = driver.findElements(By.xpath("//ul/li"));

Sample Program

This program opens a webpage, finds all buttons with class btn, prints how many it found, and prints each button's text.

Selenium Java

import org.openqa.selenium.By;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.WebElement;
import org.openqa.selenium.chrome.ChromeDriver;
import java.util.List;

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

            // Find all buttons with class 'btn'
            List<WebElement> buttons = driver.findElements(By.className("btn"));

            System.out.println("Number of buttons found: " + buttons.size());

            // Print text of each button
            for (WebElement button : buttons) {
                System.out.println("Button text: " + button.getText());
            }
        } finally {
            driver.quit();
        }
    }
}

Important Notes

If no elements match, findElements returns an empty list, not an error.

Always quit the driver to close the browser after the test.

Use meaningful locators to avoid finding wrong elements.

Summary

findElements gets all matching elements as a list.

It helps when you want to work with many similar elements.

Returns empty list if no matches, so no crash.

Practice

1. What does the Selenium method findElements return when multiple elements match the locator?

easy

A. A single WebElement or null if none found

B. Only the first matching WebElement

C. A list of all matching WebElements

D. An error if more than one element matches

Solution

1. Step 1: Understand the purpose of findElements

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

2. Step 2: Check the return type

   It returns a list (java.util.List) of WebElements, which can be empty if no matches are found.

3. Final Answer:

   A list of all matching WebElements -> Option C

4. Quick Check:

   findElements returns list = D [OK]

Hint: Remember: findElements always returns a list, even if empty [OK]

Common Mistakes:

• Confusing findElements with findElement which returns single element
• Expecting an error when multiple matches occur
• Assuming null is returned if no matches

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

easy

A. List<WebElement> buttons = driver.findElements(By.tagName("button"));

B. WebElement buttons = driver.findElements(By.tagName("button"));

C. List<WebElement> buttons = driver.findElement(By.tagName("button"));

D. WebElement buttons = driver.findElement(By.tagName("button"));

Solution

1. Step 1: Identify correct method and return type

   To get multiple elements, use findElements which returns a List<WebElement>.

2. Step 2: Check syntax correctness

   List<WebElement> buttons = driver.findElements(By.tagName("button")); correctly uses List<WebElement> and findElements with By.tagName("button").

3. Final Answer:

   List<WebElement> buttons = driver.findElements(By.tagName("button")); -> Option A

4. Quick Check:

   Multiple elements need findElements + List [OK]

Hint: Use findElements with List<WebElement> for multiple matches [OK]

Common Mistakes:

• Using findElement instead of findElements for multiple elements
• Assigning findElements result to a single WebElement variable
• Mixing findElement with List type

3. What will be the output of the following code snippet?

List<WebElement> items = driver.findElements(By.className("item"));
System.out.println(items.size());

Assuming the page has 4 elements with class "item".

medium

A. 1

B. 4

C. 0

D. Throws NoSuchElementException

Solution

1. Step 1: Understand findElements behavior

   findElements returns a list of all matching elements. Here, 4 elements have class "item".

2. Step 2: Check the size of the list

   Calling items.size() returns the number of elements found, which is 4.

3. Final Answer:

   4 -> Option B

4. Quick Check:

   items.size() = 4 [OK]

Hint: items.size() gives count of all matched elements [OK]

Common Mistakes:

• Expecting findElements to throw exception if multiple matches
• Confusing findElements with findElement which throws exception if none
• Assuming size() returns 1 always

4. Identify the error in the following code snippet:

List<WebElement> links = driver.findElements(By.cssSelector("a.link"));
System.out.println(links.get(5).getText());

Assuming the page has only 3 matching elements.

medium

A. Syntax error in CSS selector

B. NoSuchElementException thrown by findElements

C. NullPointerException because links is null

D. IndexOutOfBoundsException at links.get(5)

Solution

1. Step 1: Check findElements result size

   findElements returns a list with 3 elements because only 3 match the selector.

2. Step 2: Accessing index 5 causes error

   Trying to get element at index 5 (6th element) causes IndexOutOfBoundsException because list size is 3.

3. Final Answer:

   IndexOutOfBoundsException at links.get(5) -> Option D

4. Quick Check:

   Accessing invalid index = IndexOutOfBoundsException [OK]

Hint: Check list size before accessing by index to avoid errors [OK]

Common Mistakes:

• Expecting NoSuchElementException from findElements when no matches
• Assuming list is null if no matches (it's empty, not null)
• Ignoring list size before get(index)

5. You want to click all buttons with class "submit-btn" on a page. Which code snippet correctly does this using findElements?

hard

A. List<WebElement> buttons = driver.findElements(By.className("submit-btn"));
for(WebElement btn : buttons) {
btn.click();
}

B. WebElement button = driver.findElement(By.className("submit-btn"));
button.click();

C. List<WebElement> buttons = driver.findElement(By.className("submit-btn"));
for(WebElement btn : buttons) {
btn.click();
}

D. driver.findElements(By.className("submit-btn")).click();

Solution

1. Step 1: Use findElements to get all matching buttons

   List<WebElement> buttons = driver.findElements(By.className("submit-btn")); for(WebElement btn : buttons) { btn.click(); } correctly uses findElements to get a List of all buttons with class "submit-btn".

2. Step 2: Iterate over list and click each button

   The for-each loop clicks each button in the list, which is the correct way to handle multiple elements.

3. Final Answer:

   List<WebElement> buttons = driver.findElements(By.className("submit-btn")); for(WebElement btn : buttons) { btn.click(); } -> Option A

4. Quick Check:

   findElements + loop to click all = B [OK]

Hint: Use findElements + loop to act on multiple elements [OK]

Common Mistakes:

• Using findElement which returns only one element
• Trying to call click() directly on list
• Assigning findElements result to single WebElement