What is By.className() in Selenium?

By.className() is a Selenium locator used to identify web elements using their class attribute. It works well when the class name is unique or identifies a group of similar elements.

Can By.className() handle multiple class names?

No. By.className() only works with a single class name. If an element has multiple classes (e.g., 'btn primary'), you should use CSS selectors or XPath instead.

What should I do if multiple elements share the same class?

Use driver.findElements(By.className()) to get a list of all matching elements and access the one you need using indexing.

Why is By.className() failing with NoSuchElementException?

The class may not exist, may be misspelled, or the element may not have loaded yet. You can fix this by verifying the class value or using WebDriverWait.

When should I avoid using By.className()?

Avoid using it when an element has multiple classes or when the class attribute is dynamic. In such cases, By.cssSelector() or By.xpath() is a better choice.

How to Locate Elements Using By.className() in Selenium WebDriver

← Previous

Selenium WebDriver provides multiple ways to locate elements, and one of them is using their class attribute with the method By.className().

🔎 What is the `class` Attribute in HTML?

The class attribute in HTML is commonly used to apply CSS styles or JavaScript functions to groups of elements. It’s often shared by multiple elements.

<button class="btn submit-btn">Submit</button>

✅ When to Use `By.className()`?

✅ When elements have a common styling class name
✅ When you want to select groups of elements
✅ When the class name is unique or reliably identifies the element

📌 Syntax in Java

driver.findElement(By.className("class_name"));

💡 HTML Example

Example of a form button using the class name:

<button class="login-btn">Login</button>

💻 Selenium + Java Example

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

public class ClickByClassName {
    public static void main(String[] args) {
        System.setProperty("webdriver.chrome.driver", "path/to/chromedriver");
        WebDriver driver = new ChromeDriver();

        driver.get("https://example.com");

        // Locate element using className
        WebElement loginButton = driver.findElement(By.className("login-btn"));
        loginButton.click();

        driver.quit();
    }
}

✅ Best Practices

Tip	Why?
Use single class name only	`By.className()` doesn’t support multiple class names (like “btn primary”)
Validate uniqueness	Make sure class uniquely identifies the element
Use `findElements()` for multiple elements	If multiple elements share the same class

⚠️ Common Issues

Issue	Solution
Multiple class names	Use only one class name. Prefer `By.cssSelector()` for more complex selection.
NoSuchElementException	Class might not exist or element not loaded yet → use waits

🧪 Example with Multiple Matching Elements

If you want to click the second item in a list of elements with the same class:

List<WebElement> items = driver.findElements(By.className("menu-item"));
items.get(1).click(); // Click second item

📚 Summary

By.className() is useful for locating elements with simple, single class names.

It does not work with compound class names like “btn primary”.

For more complex needs, prefer By.cssSelector() or By.xpath().

🚀 What’s Next?

Explore other Selenium locators: