Checkbox handling in Selenium Java - Build an Automation Script

Verify checkbox selection and deselection on the preferences page

Preconditions (2)

Step 1: Locate the checkbox labeled 'Receive newsletter'

Step 2: Check if the checkbox is not selected

Step 3: Click the checkbox to select it

Step 4: Verify the checkbox is selected

Step 5: Click the checkbox again to deselect it

Step 6: Verify the checkbox is not selected

✅ Expected Result: The checkbox can be selected and deselected correctly, reflecting the user's choice.

Automation Requirements - Selenium WebDriver with JUnit 5

Assertions Needed:

Verify checkbox is initially not selected

Verify checkbox is selected after clicking

Verify checkbox is not selected after clicking again

Best Practices:

Use explicit waits to ensure checkbox is interactable

Use By.id or By.cssSelector for locating checkbox

Use Page Object Model to separate page elements and test logic

Use assertions from JUnit 5 for validation

Automated Solution

Selenium Java

import org.junit.jupiter.api.AfterEach;
import org.junit.jupiter.api.BeforeEach;
import org.junit.jupiter.api.Test;
import org.openqa.selenium.By;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.WebElement;
import org.openqa.selenium.chrome.ChromeDriver;
import org.openqa.selenium.support.ui.ExpectedConditions;
import org.openqa.selenium.support.ui.WebDriverWait;
import java.time.Duration;
import static org.junit.jupiter.api.Assertions.*;

public class CheckboxHandlingTest {
    private WebDriver driver;
    private WebDriverWait wait;

    @BeforeEach
    public void setUp() {
        driver = new ChromeDriver();
        wait = new WebDriverWait(driver, Duration.ofSeconds(10));
        driver.get("https://example.com/preferences");
    }

    @Test
    public void testCheckboxSelectionAndDeselection() {
        By newsletterCheckboxLocator = By.id("receiveNewsletter");

        // Wait until checkbox is visible and enabled
        WebElement checkbox = wait.until(ExpectedConditions.elementToBeClickable(newsletterCheckboxLocator));

        // Verify checkbox is initially not selected
        assertFalse(checkbox.isSelected(), "Checkbox should not be selected initially");

        // Click to select checkbox
        checkbox.click();

        // Verify checkbox is selected
        assertTrue(checkbox.isSelected(), "Checkbox should be selected after clicking");

        // Click again to deselect checkbox
        checkbox.click();

        // Verify checkbox is not selected
        assertFalse(checkbox.isSelected(), "Checkbox should not be selected after clicking again");
    }

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

This test uses Selenium WebDriver with JUnit 5 to automate checkbox handling.

Setup: We open the browser and navigate to the preferences page.

Wait: We wait explicitly until the checkbox is clickable to avoid timing issues.

Assertions: We check the checkbox is initially not selected, then click it and verify it is selected, then click again and verify it is deselected.

Teardown: We close the browser after the test to clean up.

This approach ensures the test is stable and easy to maintain.

Common Mistakes - 3 Pitfalls

Using Thread.sleep() instead of explicit waits

Locating checkbox with brittle XPath like absolute paths

Not verifying checkbox state before and after clicking

Bonus Challenge

Now add data-driven testing with 3 different checkboxes: 'Receive newsletter', 'Enable notifications', 'Accept terms'.

Show Hint

Practice

1. What does the isSelected() method do when working with checkboxes in Selenium Java?

easy

A. It unchecks the checkbox if it is selected.

B. It clicks the checkbox to select it.

C. It finds the checkbox element on the page.

D. It checks if the checkbox is currently selected or not.

Solution

1. Step 1: Understand the purpose of isSelected()

   This method returns a boolean indicating if the checkbox is checked (true) or unchecked (false).

2. Step 2: Differentiate from other actions

   Clicking changes state, finding locates elements, but isSelected() only checks state.

3. Final Answer:

   It checks if the checkbox is currently selected or not. -> Option D

4. Quick Check:

   Check state = isSelected() [OK]

Hint: Remember: isSelected() only checks checkbox state [OK]

Common Mistakes:

• Confusing isSelected() with click()
• Thinking isSelected() changes checkbox state
• Using isSelected() to find elements

2. Which of the following is the correct way to click a checkbox located by its ID "subscribe" in Selenium Java?

easy

A. driver.click(By.id("subscribe"));

B. driver.findElement(By.name("subscribe")).click();

C. driver.findElement(By.id("subscribe")).click();

D. driver.findElement(By.id("subscribe")).select();

Solution

1. Step 1: Identify correct method to find element by ID

   Use driver.findElement(By.id("subscribe")) to locate the checkbox by its ID.

2. Step 2: Use correct method to click checkbox

   Use .click() on the found element to toggle checkbox state.

3. Final Answer:

   driver.findElement(By.id("subscribe")).click(); -> Option C

4. Quick Check:

   Find by ID + click() = driver.findElement(By.id("subscribe")).click(); [OK]

Hint: Use findElement(By.id()).click() to toggle checkbox [OK]

Common Mistakes:

• Using driver.click() directly
• Using wrong locator like By.name instead of By.id
• Using non-existent select() method

3. Consider this code snippet:

WebElement checkbox = driver.findElement(By.id("agree"));
if (!checkbox.isSelected()) {
    checkbox.click();
}
System.out.println(checkbox.isSelected());

What will be printed if the checkbox was initially unchecked?

medium

A. false

B. true

C. null

D. Throws exception

Solution

1. Step 1: Check initial checkbox state

   The checkbox is initially unchecked, so isSelected() returns false.

2. Step 2: Click checkbox if not selected

   Since it is not selected, checkbox.click() runs, selecting it.

3. Step 3: Print final state

   After clicking, isSelected() returns true, so true is printed.

4. Final Answer:

   true -> Option B

5. Quick Check:

   Unchecked + click = selected = true [OK]

Hint: Click only if not selected to ensure checkbox is checked [OK]

Common Mistakes:

• Assuming initial state remains unchanged
• Expecting false after click
• Confusing isSelected() return values

4. You wrote this code to select a checkbox:

WebElement cb = driver.findElement(By.id("option1"));
if (cb.isSelected()) {
    cb.click();
}

But the checkbox remains unselected after running. What is the error?

medium

A. The condition should check if checkbox is NOT selected before clicking.

B. You should use cb.select() instead of cb.click().

C. The locator By.id("option1") is incorrect.

D. You need to use cb.isEnabled() before clicking.

Solution

1. Step 1: Analyze the condition logic

   The code clicks the checkbox only if it is already selected, which unchecks it.

2. Step 2: Understand desired action

   To select the checkbox, click it only if it is NOT selected.

3. Step 3: Correct the condition

   Change condition to if (!cb.isSelected()) { cb.click(); } to select checkbox.

4. Final Answer:

   The condition should check if checkbox is NOT selected before clicking. -> Option A

5. Quick Check:

   Click only if not selected to select [OK]

Hint: Click checkbox only if it is not selected [OK]

Common Mistakes:

• Clicking checkbox when already selected
• Using non-existent select() method
• Ignoring checkbox state before clicking

5. You want to ensure a checkbox with ID "terms" is selected before submitting a form. Which code snippet correctly handles this and avoids unnecessary clicks?

hard

A. WebElement cb = driver.findElement(By.id("terms"));
if (!cb.isSelected()) {
cb.click();
}
// proceed to submit

B. WebElement cb = driver.findElement(By.id("terms"));
cb.click();
// proceed to submit

C. WebElement cb = driver.findElement(By.id("terms"));
if (cb.isSelected()) {
cb.click();
}
// proceed to submit

D. WebElement cb = driver.findElement(By.id("terms"));
cb.isSelected();
// proceed to submit

Solution

1. Step 1: Check checkbox state before clicking

   Use isSelected() to verify if checkbox is already selected.

2. Step 2: Click only if not selected

   Click checkbox only when it is not selected to avoid toggling off.

3. Step 3: Avoid unnecessary clicks

   WebElement cb = driver.findElement(By.id("terms")); if (!cb.isSelected()) { cb.click(); } // proceed to submit correctly implements this logic, ensuring checkbox is selected before submit.

4. Final Answer:

   Code that clicks checkbox only if not selected before submit. -> Option A

5. Quick Check:

   Check state, click if false, then submit [OK]

Hint: Click checkbox only if not selected to ensure correct state [OK]

Common Mistakes:

• Clicking checkbox unconditionally causing toggle off
• Clicking checkbox when already selected
• Ignoring checkbox state before submit