findElement by className in Selenium Java - Framework Patterns

Framework Mode - findElement by className

Folder Structure

src/
└── test/
    └── java/
        └── com/
            └── example/
                ├── pages/
                │   └── LoginPage.java
                ├── tests/
                │   └── LoginTest.java
                ├── utils/
                │   └── WebDriverFactory.java
                └── config/
                    └── ConfigReader.java
    

Test Framework Layers

• Driver Layer: Manages WebDriver setup and teardown (e.g., WebDriverFactory).
• Page Objects: Classes representing web pages with locators and methods. Use findElement(By.className("className")) here.
• Tests: Test classes using test frameworks like TestNG or JUnit to run test cases.
• Utilities: Helper classes for common functions like waits, logging, or data handling.
• Configuration: Reads environment settings, browser types, and credentials.

Configuration Patterns

Use property files (e.g., config.properties) to store environment URLs, browser types, and credentials.

Load these properties in ConfigReader.java and pass them to WebDriver setup.

Example snippet in WebDriverFactory.java:

String browser = ConfigReader.getProperty("browser");
switch (browser.toLowerCase()) {
  case "chrome":
    // setup ChromeDriver
    break;
  case "firefox":
    // setup FirefoxDriver
    break;
  default:
    throw new IllegalArgumentException("Unsupported browser: " + browser);
}
    

Test Reporting and CI/CD Integration

• Use TestNG built-in reports or integrate with Allure for detailed HTML reports.
• Configure CI/CD pipelines (e.g., Jenkins, GitHub Actions) to run tests on code commits.
• Publish reports as build artifacts and notify teams on failures.

Best Practices

1. Use Page Object Model: Keep locators and page actions in page classes to separate test logic from UI details.
2. Use explicit waits: Avoid flaky tests by waiting for elements to be visible or clickable before interacting.
3. Use descriptive class names: When using By.className, ensure the class uniquely identifies the element.
4. Avoid brittle locators: Prefer stable class names and avoid dynamic or auto-generated classes.
5. Centralize configuration: Manage environment and browser settings in one place for easy changes.

Self Check

Where in this folder structure would you add a new page object class for a "Dashboard" page that uses findElement(By.className("dashboard-header")) to locate the header element?

Key Result

Organize Selenium Java tests using Page Object Model with clear folder layers and centralized config for maintainability.

Practice

1. What does the Selenium method findElement(By.className("btn-primary")) do in a test script?

easy

A. It finds an element by its HTML tag name "btn-primary".

B. It finds all web elements with the CSS class "btn-primary" on the page.

C. It finds the first web element with the CSS class "btn-primary" on the page.

D. It finds an element by its ID "btn-primary".

Solution

1. Step 1: Understand the method purpose

   The method findElement locates a single element on the page.

2. Step 2: Analyze the locator type

   Using By.className("btn-primary") targets elements with the CSS class "btn-primary".

3. Final Answer:

   It finds the first web element with the CSS class "btn-primary" on the page. -> Option C

4. Quick Check:

   findElement + className = first matching element [OK]

Hint: findElement with className returns first matching element [OK]

Common Mistakes:

• Confusing findElement with findElements (plural)
• Using className to find by ID or tag
• Expecting multiple elements returned

2. Which of the following is the correct syntax to find an element by class name "login-button" in Selenium Java?

easy

A. driver.findElement(By.classname("login-button"));

B. driver.findElement(By.className("login-button"));

C. driver.findElement(By.class_name("login-button"));

D. driver.findElement(By.class("login-button"));

Solution

1. Step 1: Recall correct method usage

   The correct method to locate by class name is By.className() with capital N.

2. Step 2: Check syntax correctness

   driver.findElement(By.className("login-button")); uses the exact correct syntax: By.className("login-button").

3. Final Answer:

   driver.findElement(By.className("login-button")); -> Option B

4. Quick Check:

   Correct method name is className with capital N [OK]

Hint: Use By.className with capital N for correct syntax [OK]

Common Mistakes:

• Using By.class instead of By.className
• Wrong method casing like class_name or classname
• Missing quotes around class name

3. Given the HTML snippet:

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

What will the following code return?

WebElement btn = driver.findElement(By.className("primary"));
System.out.println(btn.getText());

medium

A. Submit

B. primary

C. submit-btn

D. NoSuchElementException

Solution

1. Step 1: Locate element by class name "primary"

   The button has class "primary" among others, so it matches.

2. Step 2: Get the text of the found element

   The getText() method returns the visible text inside the button, which is "Submit".

3. Final Answer:

   Submit -> Option A

4. Quick Check:

   findElement by className finds element, getText returns inner text [OK]

Hint: getText() returns visible text inside found element [OK]

Common Mistakes:

• Expecting class name as text output
• Confusing class attribute with element text
• Assuming exception if multiple classes present

4. What is wrong with this Selenium Java code snippet?

WebElement element = driver.findElement(By.className("btn primary"));

It tries to find an element with classes "btn" and "primary".

medium

A. The syntax is correct; it finds elements with both classes.

B. It should use findElements instead of findElement.

C. It should use By.id instead of By.className.

D. className locator cannot contain spaces; it matches only one class.

Solution

1. Step 1: Understand className locator rules

   The By.className locator accepts only a single class name without spaces.

2. Step 2: Identify the error in locator usage

   Using "btn primary" with space is invalid and causes an error; it cannot find elements with multiple classes this way.

3. Final Answer:

   className locator cannot contain spaces; it matches only one class. -> Option D

4. Quick Check:

   className accepts single class only, no spaces [OK]

Hint: Use single class name without spaces in className locator [OK]

Common Mistakes:

• Trying to find multiple classes with space-separated string
• Expecting findElement to accept compound class selectors
• Confusing className with CSS selector syntax

5. You want to click the first button with class "nav-item active" on a page. Which is the best way to do this using Selenium Java?

hard

A. driver.findElement(By.cssSelector(".nav-item.active")).click();

B. driver.findElement(By.className("nav-item active")).click();

C. driver.findElement(By.className("nav-item")).click();

D. driver.findElement(By.xpath("//button[@class='nav-item active']")).click();

Solution

1. Step 1: Understand limitation of className locator

   The By.className locator cannot handle multiple classes separated by spaces.

2. Step 2: Use CSS selector for multiple classes

   The CSS selector .nav-item.active matches elements with both classes and works correctly.

3. Step 3: Compare other options

   driver.findElement(By.className("nav-item active")).click(); is invalid due to space in className; driver.findElement(By.className("nav-item")).click(); matches only one class; driver.findElement(By.xpath("//button[@class='nav-item active']")).click(); uses XPath but is less concise.

4. Final Answer:

   driver.findElement(By.cssSelector(".nav-item.active")).click(); -> Option A

5. Quick Check:

   Use CSS selector for multiple classes, not className [OK]

Hint: Use CSS selector for multiple classes, not className [OK]

Common Mistakes:

• Using className with multiple classes separated by space
• Using only one class when both are needed
• Ignoring CSS selectors as a better alternative