findElement by name in Selenium Java

Introduction

We use findElement by name to locate a web page element using its name attribute. This helps us interact with that element in tests.

When you want to fill a form field identified by its name attribute.

When you need to click a button or link that has a unique name attribute.

When you want to verify the presence or value of an input element by its name.

When other locators like id or class are not available but name is unique.

When automating simple web pages where name attributes are reliable.

Syntax

Selenium Java

WebElement element = driver.findElement(By.name("elementName"));

Replace "elementName" with the actual name attribute value of the element.

This returns the first matching element with that name on the page.

Examples

Finds the input field where the name attribute is username.

Selenium Java

WebElement usernameField = driver.findElement(By.name("username"));

Finds the search box element with name q, common in search forms.

Selenium Java

WebElement searchBox = driver.findElement(By.name("q"));

Finds a button or input element named submit to click or check.

Selenium Java

WebElement submitButton = driver.findElement(By.name("submit"));

Sample Program

This test script opens a login page, finds username and password fields by their name attributes, fills them, and clicks the login button. It prints a success message if all elements are found and clicked.

Selenium Java

import org.openqa.selenium.By;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.WebElement;
import org.openqa.selenium.chrome.ChromeDriver;

public class FindElementByNameExample {
    public static void main(String[] args) {
        System.setProperty("webdriver.chrome.driver", "path/to/chromedriver");
        WebDriver driver = new ChromeDriver();
        try {
            driver.get("https://example.com/login");
            WebElement username = driver.findElement(By.name("username"));
            username.sendKeys("testuser");
            WebElement password = driver.findElement(By.name("password"));
            password.sendKeys("mypassword");
            WebElement loginButton = driver.findElement(By.name("login"));
            loginButton.click();
            System.out.println("Login form submitted successfully.");
        } catch (Exception e) {
            System.out.println("Element not found or error occurred.");
        } finally {
            driver.quit();
        }
    }
}

Important Notes

Always ensure the name attribute is unique or you get the first matching element only.

If the element is not found, Selenium throws a NoSuchElementException.

Use explicit waits if the element loads dynamically to avoid errors.

Summary

findElement by name locates elements using their name attribute.

It is useful for form inputs and buttons with unique names.

Remember to handle exceptions if elements are missing.

Practice

1. What does the Selenium method findElement(By.name("username")) do in a test script?

easy

A. It finds all elements with the tag name "username".

B. It finds the first web element with the attribute name="username".

C. It clicks on the element with id "username".

D. It waits for the element with class "username" to appear.

Solution

1. Step 1: Understand the method purpose

   The method findElement(By.name("username")) searches for a single element with the name attribute equal to "username".

2. Step 2: Differentiate from other locators

   This method does not search by tag, id, or class, only by the name attribute.

3. Final Answer:

   It finds the first web element with the attribute name="username". -> Option B

4. Quick Check:

   findElement(By.name) = finds element by name attribute [OK]

Hint: Remember: findElement(By.name) targets the name attribute [OK]

Common Mistakes:

• Confusing name with id or class attributes
• Thinking it finds multiple elements instead of one
• Assuming it performs a click automatically

2. Which of the following is the correct syntax to find an element by its name attribute "email" in Selenium Java?

easy

A. driver.findElement(By.tagName("email"));

B. driver.findElement(By.id("email"));

C. driver.findElement(By.name("email"));

D. driver.findElement(By.className("email"));

Solution

1. Step 1: Identify the correct locator method

   To find an element by its name attribute, the correct method is By.name("email").

2. Step 2: Verify syntax correctness

   The syntax driver.findElement(By.name("email")); is valid and correctly uses the name locator.

3. Final Answer:

   driver.findElement(By.name("email")); -> Option C

4. Quick Check:

   Use By.name for name attribute [OK]

Hint: Use By.name("value") to find element by name attribute [OK]

Common Mistakes:

• Using By.id or By.className instead of By.name
• Missing quotes around the name value
• Using incorrect method names

3. What will happen when the following code runs if the page contains an input element <input name="search">?

WebElement element = driver.findElement(By.name("search"));
System.out.println(element.getTagName());

medium

A. It prints "input" to the console.

B. It throws a NoSuchElementException.

C. It prints "search" to the console.

D. It prints "name" to the console.

Solution

1. Step 1: Locate element by name attribute

   The code finds the element with name="search", which is an input tag.

2. Step 2: Print the tag name of the found element

   The method getTagName() returns the tag name of the element, which is "input".

3. Final Answer:

   It prints "input" to the console. -> Option A

4. Quick Check:

   getTagName() returns tag name [OK]

Hint: getTagName() returns the HTML tag, not attribute values [OK]

Common Mistakes:

• Expecting getTagName() to return attribute value
• Assuming element not found causes print output
• Confusing attribute name with tag name

4. Given the code snippet below, what is the main issue that will cause a failure?

WebElement element = driver.findElement(By.name("submitBtn"));
element.click();

Assume the page does not have any element with name="submitBtn".

medium

A. The code will compile but silently fail.

B. NullPointerException will be thrown at click().

C. The element will be found but click will do nothing.

D. NoSuchElementException will be thrown at findElement.

Solution

1. Step 1: Understand findElement behavior when element missing

   If no element matches the locator, findElement throws NoSuchElementException.

2. Step 2: Check what happens before click()

   The exception occurs before click() is called, so click is never reached.

3. Final Answer:

   NoSuchElementException will be thrown at findElement. -> Option D

4. Quick Check:

   Missing element causes NoSuchElementException [OK]

Hint: findElement throws exception if element not found [OK]

Common Mistakes:

• Expecting null instead of exception
• Thinking click() causes NullPointerException
• Assuming silent failure without error

5. You want to fill a form field with name="userEmail" but sometimes the element is inside an iframe. Which approach correctly finds the element by name and handles the iframe?

hard

A. Switch to iframe first, then use driver.findElement(By.name("userEmail")).

B. Use driver.findElement(By.name("userEmail")) directly without switching frames.

C. Use driver.findElement(By.id("userEmail")) after switching to iframe.

D. Switch to iframe after finding the element by name.

Solution

1. Step 1: Understand iframe context in Selenium

   Elements inside iframes require switching the driver's context to that iframe before locating elements inside it.

2. Step 2: Apply correct order of operations

   First switch to the iframe, then use findElement(By.name("userEmail")) to locate the element inside it.

3. Final Answer:

   Switch to iframe first, then use driver.findElement(By.name("userEmail")). -> Option A

4. Quick Check:

   Switch to iframe before locating inside it [OK]

Hint: Always switch to iframe before finding elements inside it [OK]

Common Mistakes:

• Trying to find element inside iframe without switching
• Using wrong locator like id instead of name
• Switching to iframe after locating element