Handling Checkbox in Selenium in 2026

Related Product

Ever wondered why acheckbox testwalk locally but deport inconsistently in another browser?

Like many testers, I assumedcheckbox handling in Seleniumwas as bare as site an element and clicking it.

That belief changed whena test that worked on my system failed on another browser, detent weren ’ t registered, or the checkbox state didn ’ t update as expected. Adding waits and revisiting locators didn ’ t help.

Understanding how toproperly handle, verify, and deselect checkboxes in Selenium, and validating those interaction on real browser, can save hour of.

WebDriver driver = new ChromeDriver (); driver.get (`` https: //example.com ''); // Locate the checkbox WebElement checkbox = driver.findElement (By.id (`` acceptTerms '')); // Select the checkbox if not already selected if (! checkbox.isSelected ()) {checkbox.click ();} // Assert checkbox province Assert.assertTrue (checkbox.isSelected (), `` Checkbox is not selected '');

This clause extend how to handle, control, and deselect checkboxes in Selenium

What is a Checkbox?

A checkbox, also cognise as a selection box or tick box, is a small interactive UI element that allows users to select one or more options on a web page.

When selected, a checkmark appears inside the box to indicate the chosen option. Clicking the checkbox again deselects it, making checkboxes ideal for choose single or multiple values from a set of selection.

In web automation, checkboxes are treated like other interactional elements such as input battleground, buttons, and linkup, and must be dependably automated to ruminate real user behavior.

According toSarah Thomas, a package try expert,checkbox automationshould alwaysverify the element ’ s stateuse methods likeisSelected ()before and after interaction. This ensures that thecheckbox state truly reflects the intended exploiter activeness and helps prevent flaky examination effectacross browsers.

Since checkbox rendering and interaction can vary across browsers and platforms, formalize these interaction on existent browser is essential.

Platforms like help ensure checkbox mechanization behaves consistently across different browser and operating scheme.

How to handle Checkbox in Selenium?

Before spring to how to select/deselect a checkbox on a web page employ Selenium, let us firstly learn how to locate a checkbox using Selenium. Selenium volunteer various locator strategies and near all of them can be used to locate a cheque box. Let us see some one of them with an example.

Using W3Schoolswebsite to demonstrate situate checkboxes on web pages using Selenium.

Click on “Try it Yourself button” to land to
https: //www.w3schools.com/tags/tryit.asp? filename=tryhtml5_input_type_checkbox

(Note: If the above practice page appears separate for you, you may simply search “ w3schools checkbox ” on Google.com to get the desired recitation web page)

Locate checkbox using Id locater

If a checkbox element has an id attribute which is unique, we can use the ID locator of Selenium WebDriver to situate a checkbox. A checkbox in the DOM is defined using the stimulant tag with the case as‘ checkbox ’.

Example:

& lt; input type= '' checkbox '' name= '' vehicle1 '' value= '' Bike '' & gt;

You can see from the above icon that the “ I have a motorcycle ” checkbox has an input tag with type= ’ checkbox ’ and id= ’ vehicle1 ’. If we need to place this checkbox with ID locator below would be the Selenium code:

WebElement bike=driver.findElement (By.id (`` # vehicle1 ''));

Selecting Checkbox in Selenium

To select any checkbox we need to use the click () method of the WebElement interface of Selenium.

bike.click ();

After the dog operation, the checkbox should appear to be selected as present in below image:

Locate checkbox habituate name locator

If a checkbox element has a name property which is unique, we can use the name locater of Selenium WebDriver to place a checkbox.

You can see from the above image that the “ I experience a bike ” checkbox has the name= ’ vehicle1 ’. If we demand to locate this checkbox with name locator below would be the Selenium code:

WebElement bike=driver.findElement (By.name (`` vehicle1 ''));

To select any checkbox we need to use theclick()method of WebElement Interface of Selenium.

bike.click ();

Locate checkbox using XPath locator

Sometimes Selenium can not find a checkbox with just the id or name value or any former property, and therefore XPath is deal in such case.

You can see from the above image that the “ I have a bike ” checkbox has an input tag with name= ’ vehicle1 ’ and id = ‘ vehicle1 ’. If we ask to locate this checkbox with XPath locator below would be the Selenium code:

WebElement bike=driver.findElement (By.xpath (`` //input [@ name='vehicle1 ' and @ id='vehicle1 '] ''));

To take any checkbox we ask to use theclick()method of WebElement Interface of Selenium.

bike.click ();

Locate checkbox apply CSSSelector

Like XPath, CSSSelector can also be used if Selenium can not find a checkbox with just the id or gens or any early attribute value.

You can see from the above image that the “ I feature a wheel ” checkbox has an comment tag with type= ’ checkbox ’, id = ‘ vehicle1 ’. If we need to locate this checkbox with CSSSelector locater below would be the Selenium code:

WebElement bike=driver.findElement (By.cssSelector (`` input # vehicle1 ''));

Pro tip: Tools like SUSA can handle this autonomously — upload your app and get results without writing a single test script.

To choose any checkbox we take to use theclick()method of WebElement Interface of Selenium.

bike.click ();

Locate checkbox using Attribute value

Sometimes a group of checkboxes may experience the like name or class or id value, which makes it difficult to check a single checkbox. In such lawsuit, checkboxes can be located by expend their value attribute as each checkbox has a unique value attribute to it.

If we need to situate “ I have a bike ” checkbox with value dimension we can use CSSSelector and below would be the Selenium code:

WebElement bike=driver.findElement (By.cssSelector (`` input [value='Bike '] ''));

To select any checkbox we need to use theclick()method of WebElement Interface of Selenium.

bike.click ();

How to Select multiple pick in Checkbox using Selenium

In the above example, we learned that in some web pages, there may be a group of checkboxes which experience the like name/class/id attribute and therefore choosing the checkbox with respect to their value property is the good option if we need to click on a individual checkbox.

And if there is a demand to select multiple checkboxes which feature the like name/id/class attribute but different attribute values, creating different web elements and so chatter on it one by one would be cumbersome. Instead we can create a list of web elements and iterate through it consecutive and click on it.

Let us see how we can take all checkboxes in the above example with the below Selenium codification.

• First, we will make a List of web elements to store all the checkboxes.

List & lt; WebElement & gt; chkboxes=driver.findElements (By.cssSelector (`` input [type='checkbox '] ''));

• Then we involve to find out the size of the web element list.

int size=chkboxes.size ();

• Then using the for loop andget()method we will retell through all the check box and click on it using theclick() method.

chkboxes.get (i) .click ();

Complete codification:

public class CheckBox {public electrostatic nothingness independent (String args []) {WebDriver driver=new ChromeDriver (); driver.get (`` https: //www.w3schools.com/tags/tryit.asp? filename=tryhtml5_input_type_checkbox ''); //Switch to the iframe which contain the checkboxes driver.switchTo () .frame (`` iframeResult ''); List & lt; WebElement & gt; chkboxes=driver.findElements (By.cssSelector (`` input [type='checkbox '] '')); int size=chkboxes.size (); for (int i=0; i & lt; sizing; i++) {chkboxes.get (i) .click ();}}}

Validations on a checkbox employ Selenium

To corroborate pre and post conditions of checkbox ’ s state, Selenium provides certain methods which are as follows:

• isEnabled ():A pre-validation for checkbox click event to check whether the checkbox is enabled or disable on the web page. This method returns true in case element is enable differently it regress false.
• isDisplayed ():A pre-validation for checkbox click event to check whether the checkbox is displayed on the web page or not. It retrovert true if the coveted constituent is displayed on DOM otherwise it regress false.
• isSelected ():A post-validation after the checkbox click case to see whether the checkbox is selected or not. It returns true if the constituent is selected, else mistaken for deselected.

Suppose there is a scenario where the user needs to first check the visibility of the checkbox and based on the visibility it needs to be take. So in such a condition we can useisDisplayed ()method as a precondition and on the basis of its result either true or mistaken, the checkbox can be selected.

public class CheckBox {public static void main (String args []) {WebDriver driver = new ChromeDriver (); driver.get (`` https: //www.w3schools.com/tags/tryit.asp? filename=tryhtml5_input_type_checkbox ''); // Switch to the iframe which contains the checkboxes driver.switchTo () .frame (`` iframeResult ''); WebElement car = driver.findElement (By.cssSelector (`` input # vehicle2 '')); System.out.println (`` car.isDisplayed () '' + car.isDisplayed ()); if (car.isDisplayed () ==true) {car.click ();} else {System.out.println (`` Option is not displayed '');}}}

How to assert that a checkbox is ensure?

If there is a want to formalize whether the checkbox is selected after selecting the desired checkbox, we can useisSelected ()method which regress true if the checkbox is selected and mistaken in either case. The Selenium code to examine this scenario is as follows:

public class CheckBox {public static void chief (String args []) {WebDriver driver = new ChromeDriver (); driver.get (`` https: //www.w3schools.com/tags/tryit.asp? filename=tryhtml5_input_type_checkbox ''); // Switch to the iframe which contains the checkboxes driver.switchTo () .frame (`` iframeResult ''); WebElement car = driver.findElement (By.cssSelector (`` input # vehicle2 '')); car.click (); System.out.println (`` car.isSelected () '' + car.isSelected ()); if (car.isSelected () ==true) {System.out.println (`` Option is selected '');} else {System.out.println (`` Option is not selected '');}}}

How to Deselect Checkbox in Selenium

At the start of this article we learnt that theclick()method of WebElement interface is used to click a checkbox. Similarly, to deselect a checkbox, the likeclick()method is expend.

However, in web mechanization it is a good practice to check the province of the checkbox before deselecting it, otherwise chatter to deselect the checkbox will select the checkbox if the checkbox was not in a selected mode antecedently.

public class CheckBox {public static nihility principal (String args []) {WebDriver driver = new ChromeDriver (); driver.get (`` https: //www.w3schools.com/tags/tryit.asp? filename=tryhtml5_input_type_checkbox ''); //Switch to the iframe which check the checkboxes driver.switchTo () .frame (`` iframeResult ''); WebElement car = driver.findElement (By.cssSelector (`` input # vehicle2 '')); //car.click (); System.out.println (`` car.isSelected () '' + car.isSelected ()); if (car.isSelected ()) {car.click (); System.out.println (`` Car deselected '');} else {System.out.println (`` Car is already deselected '');}}}

Ensuring Dependable Checkbox Interactions on Real Browsers with BrowserStack Automate

Checkbox interactions may appear unproblematic, but their behavior can alter across browser due to divergence in rendition, case manipulation, and updates.

A checkbox that respond aright in one browser may fail to file clicks, retrovert incorrect states, or behave inconsistently in another environs, leading to flaky.

BrowserStack Automate helps validate checkbox interactions under by allowing to run on real browser and run systems.

Key capabilities that support reliable checkbox mechanisation include:

• Real browser testing:Execute Selenium tests on real desktop and mobile browsers to catch browser-specific checkbox behavior.
• Cross-browser coverage:Validate checkbox selection, assertion, and deselection across multiple browser versions and OS combinations.
• :Run checkbox-related examination scenario simultaneously to speed up feedback and identify inconsistencies faster.
• Debugging perceptivity:Access screenshots, logs, and video recordings to analyze checkbox interaction failures.
• desegregation:Seamlessly integrate checkbox validation into automated pipelines for continuous quality assurance.

By testing checkbox interaction on real browsers with BrowserStack Automate, teams can reduce laky tests, ameliorate cross-browser confidence, and check that checkbox automation accurately reflects real user demeanour.

Conclusion

Checkboxes are bare UI elements, but automating them dependably requires careful handling of selection, substantiation, and deselection states.

Differences in browser deportment, interpretation, and event treatment can easily lead to inconsistent or flaky tryout results if these interactions are not validated properly.

By understanding how to act with checkboxes in Selenium and validating those interactions across real browsers, quizzer can build more stable and trustworthy mechanization.

Running checkbox tests in real-world environs aid catch browser-specific issue early and check that automate tests reflect actual exploiter behavior, leading to more reliable test outcomes.

Useful Resources for Selenium

Methods, Classes, and Commands

Configuration

XPath

Locators and Selectors

Waits in Selenium

Frameworks in Selenium

Miscellaneous

Best Practices, Tips and Tricks

Design Patterns in Selenium: Page Object Model and Page Factory

Action Class

TestNG and Selenium

JUnit and Selenium

Use Cases

Types of Testing with Selenium

Related Guides