findElements for multiple matches in Selenium Java - Test Execution Trace

Test Overview

This test opens a webpage and uses findElements to locate multiple buttons with the same class. It verifies that the correct number of buttons is found and that each button is displayed.

Test Code - JUnit

Selenium Java

import org.openqa.selenium.By;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.WebElement;
import org.openqa.selenium.chrome.ChromeDriver;
import org.junit.jupiter.api.AfterEach;
import org.junit.jupiter.api.BeforeEach;
import org.junit.jupiter.api.Test;
import java.util.List;
import static org.junit.jupiter.api.Assertions.*;

public class MultipleButtonsTest {
    WebDriver driver;

    @BeforeEach
    public void setUp() {
        driver = new ChromeDriver();
        driver.get("https://example.com/buttons");
    }

    @Test
    public void testFindMultipleButtons() {
        List<WebElement> buttons = driver.findElements(By.className("btn-primary"));
        assertFalse(buttons.isEmpty(), "No buttons found with class 'btn-primary'");
        assertEquals(3, buttons.size(), "Expected exactly 3 buttons with class 'btn-primary'");
        for (WebElement button : buttons) {
            assertTrue(button.isDisplayed(), "Button should be visible");
        }
    }

    @AfterEach
    public void tearDown() {
        if (driver != null) {
            driver.quit();
        }
    }
}

Execution Trace - 6 Steps

Step	Action	System State	Assertion	Result
1	Test starts and Chrome browser opens	Browser window is open, ready to navigate	—	PASS
2	Browser navigates to https://example.com/buttons	Page with multiple buttons having class 'btn-primary' is loaded	—	PASS
3	Find all elements with class name 'btn-primary' using findElements	List of WebElements representing buttons is retrieved	Verify list is not empty	PASS
4	Assert that exactly 3 buttons are found	List size is checked	buttons.size() == 3	PASS
5	For each button found, check if it is displayed	Each button element is visible on the page	button.isDisplayed() == true for all buttons	PASS
6	Test ends and browser closes	Browser window is closed	—	PASS

Failure Scenario

Failing Condition: No elements found with class 'btn-primary' or number of elements is not 3

Execution Trace Quiz - 3 Questions

What does the findElements method return if no matching elements are found?

A Null

B Throws NoSuchElementException

C An empty list

D Returns the first element only

Key Result

Using findElements returns a list of all matching elements, allowing tests to verify multiple elements at once without failing if none are found. Always check the list size and visibility to ensure correct elements are present.

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