Checkbox interactions in Selenium Python

Introduction

Checkboxes let users select options. Testing them ensures they work right and save user choices.

When you want to check if a checkbox can be selected or deselected.

When testing forms that have multiple options to choose from.

When verifying that the checkbox state is saved after submitting a form.

When automating user actions that involve toggling settings on or off.

When ensuring that only allowed checkboxes can be checked or unchecked.

Syntax

Selenium Python

checkbox = driver.find_element(By.CSS_SELECTOR, 'input[type="checkbox"]')
checkbox.click()

# To check if checkbox is selected
is_checked = checkbox.is_selected()

Use click() to toggle the checkbox state.

Use is_selected() to check if the checkbox is currently checked.

Examples

Find checkbox by ID and click it to select or deselect.

Selenium Python

checkbox = driver.find_element(By.ID, 'subscribe')
checkbox.click()

Check if checkbox is not selected, then click to select it.

Selenium Python

checkbox = driver.find_element(By.NAME, 'terms')
if not checkbox.is_selected():
    checkbox.click()

Select all checkboxes on the page that are not already selected.

Selenium Python

checkboxes = driver.find_elements(By.CSS_SELECTOR, 'input[type="checkbox"]')
for cb in checkboxes:
    if not cb.is_selected():
        cb.click()

Sample Program

This script opens a simple page with one checkbox. It prints if the checkbox is selected before and after clicking it twice.

Selenium Python

from selenium import webdriver
from selenium.webdriver.common.by import By
from selenium.webdriver.chrome.service import Service
from selenium.webdriver.chrome.options import Options
import time

# Setup Chrome driver (adjust path as needed)
options = Options()
options.add_argument('--headless')  # Run without opening browser window
service = Service()
driver = webdriver.Chrome(service=service, options=options)

try:
    # Open a simple page with a checkbox
    driver.get('data:text/html,<html><body><form><input type="checkbox" id="agree" name="agree">I agree</form></body></html>')

    checkbox = driver.find_element(By.ID, 'agree')

    # Initially checkbox should not be selected
    print(f'Initially selected: {checkbox.is_selected()}')

    # Click checkbox to select it
    checkbox.click()
    print(f'After click selected: {checkbox.is_selected()}')

    # Click again to deselect
    checkbox.click()
    print(f'After second click selected: {checkbox.is_selected()}')

finally:
    driver.quit()

Important Notes

Always locate checkboxes using stable locators like ID or name for reliability.

Use is_selected() to verify checkbox state instead of guessing.

Clicking a checkbox toggles its state: checked to unchecked or vice versa.

Summary

Checkboxes let users pick options; testing ensures they work correctly.

Use click() to change checkbox state and is_selected() to check it.

Choose good locators like ID or name for finding checkboxes in tests.

Practice

1. What does the is_selected() method do when used on a checkbox element in Selenium?

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 checked (selected).

Solution

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

   This method returns a boolean indicating if the checkbox is checked or not.

2. Step 2: Differentiate from other methods

   Unlike click() which changes state, is_selected() only reads the current state.

3. Final Answer:

   It checks if the checkbox is currently checked (selected). -> Option D

4. Quick Check:

   Check checkbox state = is_selected() [OK]

Hint: Remember: is_selected() reads state, click() changes it [OK]

Common Mistakes:

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

2. Which of the following is the correct way to click a checkbox using Selenium in Python?

easy

A. checkbox.toggle()

B. checkbox.click()

C. checkbox.check()

D. checkbox.select()

Solution

1. Step 1: Recall Selenium method for clicking

   The standard method to simulate a mouse click on an element is click().

2. Step 2: Verify other options

   Methods like select(), check(), or toggle() do not exist in Selenium WebDriver API.

3. Final Answer:

   checkbox.click() -> Option B

4. Quick Check:

   Click checkbox = click() method [OK]

Hint: Use click() to change checkbox state, no other method works [OK]

Common Mistakes:

• Using non-existent methods like select() or check()
• Trying to assign True/False directly to checkbox
• Confusing click() with is_selected()

3. What will be the output of the following code snippet?

checkbox = driver.find_element(By.ID, 'subscribe')
checkbox.click()
print(checkbox.is_selected())

medium

A. True

B. False

C. None

D. Throws an exception

Solution

1. Step 1: Understand the code actions

   The code finds a checkbox by ID 'subscribe', clicks it to select, then prints if it is selected.

2. Step 2: Predict the checkbox state after click()

   Clicking a checkbox toggles it to selected if it was not selected before, so is_selected() returns True.

3. Final Answer:

   True -> Option A

4. Quick Check:

   Click then check selected = True [OK]

Hint: Click toggles checkbox, is_selected() shows True if checked [OK]

Common Mistakes:

• Assuming is_selected() returns False after click
• Thinking print outputs None
• Expecting an exception without errors in code

4. You wrote this code to select a checkbox:

checkbox = driver.find_element(By.NAME, 'agree')
if not checkbox.is_selected():
    checkbox.click()

But the checkbox is never selected after running. What is the likely problem?

medium

A. The locator By.NAME with 'agree' is incorrect or does not find the checkbox.

B. The click() method does not work on checkboxes.

C. You must use checkbox.select() instead of click().

D. The is_selected() method changes the checkbox state.

Solution

1. Step 1: Analyze the locator usage

   If the checkbox is never selected, the element might not be found correctly by By.NAME, 'agree'.

2. Step 2: Check method correctness

   click() works on checkboxes, and is_selected() only reads state, so these are not the problem.

3. Final Answer:

   The locator By.NAME with 'agree' is incorrect or does not find the checkbox. -> Option A

4. Quick Check:

   Wrong locator = no click effect [OK]

Hint: Verify locators first if click has no effect [OK]

Common Mistakes:

• Assuming click() doesn't work on checkboxes
• Using non-existent methods like select()
• Thinking is_selected() changes state

5. You want to write a Selenium test that ensures a checkbox with ID 'terms' is checked only if it is not already checked. Which code snippet correctly does this?

hard

A. checkbox = driver.find_element(By.ID, 'terms')
if checkbox.is_selected():
checkbox.click()

B. checkbox = driver.find_element(By.ID, 'terms')
checkbox.click()
assert checkbox.is_selected()

C. checkbox = driver.find_element(By.ID, 'terms')
if not checkbox.is_selected():
checkbox.click()

D. checkbox = driver.find_element(By.ID, 'terms')
checkbox.select()

Solution

1. Step 1: Understand the requirement

   The checkbox should be checked only if it is not already checked to avoid toggling it off.

2. Step 2: Analyze each option

   checkbox = driver.find_element(By.ID, 'terms') if not checkbox.is_selected(): checkbox.click() checks state and clicks only if unchecked, which is correct. checkbox = driver.find_element(By.ID, 'terms') checkbox.click() assert checkbox.is_selected() always clicks, possibly unchecking. checkbox = driver.find_element(By.ID, 'terms') if checkbox.is_selected(): checkbox.click() clicks if already checked, unchecking it. checkbox = driver.find_element(By.ID, 'terms') checkbox.select() uses a non-existent method.

3. Final Answer:

   checkbox = driver.find_element(By.ID, 'terms') if not checkbox.is_selected(): checkbox.click() -> Option C

4. Quick Check:

   Check state before click to avoid toggling off [OK]

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

Common Mistakes:

• Clicking checkbox without checking state first
• Using non-existent methods like select()
• Clicking when checkbox is already selected