Locators in Selenium play an important role in the life of an automation engineer. Depending on how skilled you are in locating an element is directly proportional to the stability and efficiency of your automation testing with Selenium. There are multiple ways of utilizing locators in Selenium to find an element on a page but deciding the right one, does the business. In this article, I will be referencing on how to use by.name locator in Selenium automation scripts.

You can check out other articles around different CSS locator in Selenium that helps in locating elements through various ways:

If you are an advanced or medium Selenium practitioner, then you can chuck on dedicated articles mentioned above. And go for our complete guide to help you illustrate the practical demonstration of CSS locator in Selenium.

Check Out My Complete Guide For Every CSS Locator In Selenium WebDriver With Examples

Understanding The DOM(Document Object Model)

The Document Object Model(DOM) defines the structure of a webpage which constitutes of various tag elements and their corresponding attributes. For example, below shows the LambdaTest login page:

In the screenshot above, we are trying to locate the ‘email’ field. The DOM structure of the email field is displayed below:

< input type="email" name="email" value="" placeholder="Email" required="required" autofocus="autofocus" class="form-control mt-3 form-control-lg" >

The attributes for the above DOM structure are:

Type

Name

Value

Placeholder

Required

Autofocus

Class

Understanding The By.name Locator In Selenium

By.name locator in Selenium is used to identify the elements of a webpage. This attribute can be mentioned as part of multiple tags like < input >, < button >, < select > etc. Unlike ID, this may or may not be unique to a page. A webpage may contain multiple tags with the same By.name attribute value. In such a case, if your intent is to select your desired element, the By.name locator in Selenium may not be the correct choice.

A key point to note is when you tend to select an element with a desired name attribute value, it will select the first element it encounters. You may come across another scenario, where you wish to select elements with the same name attribute value, in this case, the By.name locator in Selenium may work using the findElements syntax. I will show both scenarios example in the code as we go ahead in the article.

In order to locate element via the By.name locator in Selenium, we use the below command:

driver.findElement(By.name(“Element NAME”));

Let’s dig into the code snippet to understand the usage of the By.namelocator.

Test Scenario 1 For By.nameLocator In Selenium

In the below code example, we are logging on to the LambdaTest platform. Here we will locate the ‘email’ and ‘password’ field using the By.name attribute.

package Chromedriver; import org.openqa.selenium.By; import org.openqa.selenium.WebDriver; import org.openqa.selenium.WebElement; import org.openqa.selenium.chrome.ChromeDriver; public class Name_Locator { public static void main(String[] args) { //Setting up chrome using chromedriver by setting its property System.setProperty("webdriver.chrome.driver", "C:\\Users\

avyug\\workspace\\Lambdatest\\src\\Chromedriver\\chromedriver.exe"); //Opening browser WebDriver driver= new ChromeDriver() ; //Opening window tab in maximize mode driver.manage().window().maximize(); //Opening application driver.get("https://accounts.lambdatest.com/login"); //Locating the email field element via Name tag and storing it in the webelement WebElement email_field=driver.findElement(By.name("email")); //Entering text into the email field email_field.sendKeys("sadhvisingh24@gmail.com"); //Locating the password field element via Name tag and storing it in the webelement WebElement password_field=driver.findElement(By.name("password")); //Entering text into the password field password_field.sendKeys("LoremIpsum"); //Clicking on the login button to login to the application WebElement login_button=driver.findElement(By.xpath("//button[text()='LOGIN']")); //Clicking on the 'login' button login_button.click(); //Closing the window driver.close(); } } 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 package Chromedriver ; import org . openqa . selenium . By ; import org . openqa . selenium . WebDriver ; import org . openqa . selenium . WebElement ; import org . openqa . selenium . chrome . ChromeDriver ; public class Name_Locator { public static void main ( String [ ] args ) { //Setting up chrome using chromedriver by setting its property System . setProperty ( "webdriver.chrome.driver" , "C:\\Users\

avyug\\workspace\\Lambdatest\\src\\Chromedriver\\chromedriver.exe" ) ; //Opening browser WebDriver driver = new ChromeDriver ( ) ; //Opening window tab in maximize mode driver . manage ( ) . window ( ) . maximize ( ) ; //Opening application driver . get ( "https://accounts.lambdatest.com/login" ) ; //Locating the email field element via Name tag and storing it in the webelement WebElement email_field = driver . findElement ( By . name ( "email" ) ) ; //Entering text into the email field email_field . sendKeys ( "sadhvisingh24@gmail.com" ) ; //Locating the password field element via Name tag and storing it in the webelement WebElement password_field = driver . findElement ( By . name ( "password" ) ) ; //Entering text into the password field password_field . sendKeys ( "LoremIpsum" ) ; //Clicking on the login button to login to the application WebElement login_button = driver . findElement ( By . xpath ( "//button[text()='LOGIN']" ) ) ; //Clicking on the 'login' button login_button . click ( ) ; //Closing the window driver . close ( ) ; } }

Test Scenario 2 For By.name Locator In Selenium

In the below code example, post-logging in, under the automation section of the menu bar, we have a page where two web elements containing radio button have the same By.name attribute value as radio. We intend to switch between these two buttons. Below is the DOM structure for both those elements:

< div class="TimelineTab_viewRadioButton__18Zf3"> < label ><input type="radio" name="radio" value="build_view"><span class="TimelineTab_labelText__2DZ00 TimelineTab_font14__2K4jw">Build View</span> <!-- label-->< label>< input type="radio" name="radio" value="test_view"> <span class="TimelineTab_labelText__2DZ00 TimelineTab_font14__2K4jw">Test View<!-- span--><!-- label -->< /div ></span> 1 2 3 4 & lt ; div class = "TimelineTab_viewRadioButton__18Zf3" & gt ; & lt ; label & gt ; < input type = "radio" name = "radio" value = "build_view" > < span class = "TimelineTab_labelText__2DZ00 TimelineTab_font14__2K4jw" > Build View < / span > < ! -- label -- > & lt ; label & gt ; & lt ; input type = "radio" name = "radio" value = "test_view" & gt ; < span class = "TimelineTab_labelText__2DZ00 TimelineTab_font14__2K4jw" > Test View < ! -- span -- > < ! -- label -- > & lt ; / div & gt ; < / span >

The code snippet below:

package Chromedriver; import java.util.List; import java.util.concurrent.TimeUnit; import org.openqa.selenium.By; import org.openqa.selenium.WebDriver; import org.openqa.selenium.WebElement; import org.openqa.selenium.chrome.ChromeDriver; public class Multiple_Name_Values { public static void main(String[] args) { //Setting up chrome using chromedriver by setting its property System.setProperty("webdriver.chrome.driver", "C:\\Users\

avyug\\workspace\\Lambdatest\\src\\Chromedriver\\chromedriver.exe"); //Opening browser WebDriver driver= new ChromeDriver() ; //Opening window tab in maximize mode driver.manage().window().maximize(); //Maintaining an implicit wait for the entire application in case of throttling network or DOM not loaded driver.manage().timeouts().implicitlyWait(20, TimeUnit.SECONDS); //Opening application driver.get("https://accounts.lambdatest.com/login"); //Locating the email field element via Name tag and storing it in the webelement WebElement email_field=driver.findElement(By.name("email")); //Entering text into the email field email_field.sendKeys("sadhvisingh24@gmail.com"); //Locating the password field element via Name tag and storing it in the webelement WebElement password_field=driver.findElement(By.name("password")); //Entering text into the password field password_field.sendKeys("LoremIpsum"); //Clicking on the login button to login to the application WebElement login_button=driver.findElement(By.xpath("//button[text()='LOGIN']")); //Clicking on the 'login' button login_button.click(); //Click on the Automation menu link on the sidebar driver.findElement(By.xpath("//*[@id='app']/header/aside/ul/li[4]/a/span")).click(); //Finding all the webelement on the page with name attribute value as radio List<webelement> radio_button=driver.findElements(By.name("radio")); //Click on the test view of the element radio_button.get(1).findElement(By.xpath("//span")).click(); //Closing the driver driver.close(); } } </webelement> 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 package Chromedriver ; import java . util . List ; import java . util . concurrent . TimeUnit ; import org . openqa . selenium . By ; import org . openqa . selenium . WebDriver ; import org . openqa . selenium . WebElement ; import org . openqa . selenium . chrome . ChromeDriver ; public class Multiple_Name_Values { public static void main ( String [ ] args ) { //Setting up chrome using chromedriver by setting its property System . setProperty ( "webdriver.chrome.driver" , "C:\\Users\

avyug\\workspace\\Lambdatest\\src\\Chromedriver\\chromedriver.exe" ) ; //Opening browser WebDriver driver = new ChromeDriver ( ) ; //Opening window tab in maximize mode driver . manage ( ) . window ( ) . maximize ( ) ; //Maintaining an implicit wait for the entire application in case of throttling network or DOM not loaded driver . manage ( ) . timeouts ( ) . implicitlyWait ( 20 , TimeUnit . SECONDS ) ; //Opening application driver . get ( "https://accounts.lambdatest.com/login" ) ; //Locating the email field element via Name tag and storing it in the webelement WebElement email_field = driver . findElement ( By . name ( "email" ) ) ; //Entering text into the email field email_field . sendKeys ( "sadhvisingh24@gmail.com" ) ; //Locating the password field element via Name tag and storing it in the webelement WebElement password_field = driver . findElement ( By . name ( "password" ) ) ; //Entering text into the password field password_field . sendKeys ( "LoremIpsum" ) ; //Clicking on the login button to login to the application WebElement login_button = driver . findElement ( By . xpath ( "//button[text()='LOGIN']" ) ) ; //Clicking on the 'login' button login_button . click ( ) ; //Click on the Automation menu link on the sidebar driver . findElement ( By . xpath ( "//*[@id='app']/header/aside/ul/li[4]/a/span" ) ) . click ( ) ; //Finding all the webelement on the page with name attribute value as radio List < webelement > radio_button = driver . findElements ( By . name ( "radio" ) ) ; //Click on the test view of the element radio_button . get ( 1 ) . findElement ( By . xpath ( "//span" ) ) . click ( ) ; //Closing the driver driver . close ( ) ; } } < / webelement >

As you can see in the above two examples, we have used the By.name locator in different ways. One was via findElement and the other was via findElements command. In one, our target was to locate a single element while in the other we located multiple elements with the same By.name and attempted to switch to one of those elements. So as per defined need and business, we can use the By.name locator. By.name locators are easy to use and maintain, the trick lies in identifying their right usage.

You can also read my previous article where I have explained the demonstration of all the locators in Selenium WebDriver. I will also be writing down a series of dedicated articles to demonstrate thorough usage of each locator of Selenium in detail. Stay tuned! 🙂