How to Handle Radio Button in Selenium: Simple Guide

To handle a radio button in Selenium, first locate it using a reliable locator like By.id or By.name, then use click() to select it. Always verify if it is selected using isSelected() before interacting to avoid errors.

Why This Happens

Many beginners try to click a radio button without properly locating it or checking if it is already selected. This can cause errors or unexpected behavior because Selenium might not find the element or tries to click an unclickable area.

java

driver.findElement(By.id("genderMale")).click();
// No check if element is present or enabled
// No verification if already selected

Output

org.openqa.selenium.NoSuchElementException: Unable to locate element: {"id":"genderMale"}

The Fix

Use a proper locator that uniquely identifies the radio button. Check if the element is displayed and enabled before clicking. Use isSelected() to verify if the radio button is already selected to avoid unnecessary clicks.

java

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

WebElement radioButton = driver.findElement(By.id("genderMale"));
if (radioButton.isDisplayed() && radioButton.isEnabled()) {
    if (!radioButton.isSelected()) {
        radioButton.click();
    }
}

Output

Radio button 'genderMale' is selected successfully without errors.

Prevention

Always use unique and stable locators like id or name for radio buttons. Avoid using brittle locators like XPath with indexes. Check element visibility and state before clicking. Use explicit waits to ensure the element is ready. This prevents errors and flaky tests.

Related Errors

Common related errors include NoSuchElementException when the locator is wrong, ElementNotInteractableException when the radio button is hidden or disabled, and StaleElementReferenceException when the page reloads after locating the element.

Quick fixes: verify locators, wait for element visibility, and re-locate elements after page changes.

Key Takeaways

Always locate radio buttons with unique, stable locators like id or name.

Check if the radio button is visible, enabled, and not already selected before clicking.

Use isSelected() to verify the radio button state to avoid unnecessary clicks.

Use explicit waits to handle dynamic page loading before interacting.

Handle common Selenium exceptions by verifying locators and element states.