ExpectedConditions class in Selenium Java - Framework Patterns

Framework Mode - ExpectedConditions class

Folder Structure

src
└── test
    └── java
        └── com
            └── example
                ├── pages
                │   └── LoginPage.java
                ├── tests
                │   └── LoginTest.java
                ├── utils
                │   └── WaitUtils.java
                └── config
                    └── TestConfig.java
    

This structure organizes page objects, tests, utilities, and configuration separately.

Test Framework Layers

• Driver Layer: Manages WebDriver setup and teardown.
• Page Objects: Classes representing web pages with locators and actions.
• Tests: Test classes using page objects and assertions.
• Utilities: Helper classes like WaitUtils that wrap ExpectedConditions for explicit waits.
• Configuration: Holds environment settings, browser options, and credentials.

The ExpectedConditions class is used in the Utilities layer to wait for specific conditions before interacting with elements.

Configuration Patterns

Use a TestConfig class or properties file to manage:

• Environment URLs (dev, staging, production)
• Browser types (Chrome, Firefox, Edge)
• Timeout durations for waits
• User credentials securely (avoid hardcoding)

Example snippet in TestConfig.java:

public class TestConfig {
    public static final String BASE_URL = System.getProperty("baseUrl", "https://example.com");
    public static final int EXPLICIT_WAIT_SECONDS = Integer.parseInt(System.getProperty("waitSeconds", "10"));
    public static final String BROWSER = System.getProperty("browser", "chrome");
}

Test Reporting and CI/CD Integration

• Use TestNG or JUnit reports for test execution results.
• Integrate Allure or ExtentReports for detailed HTML reports with screenshots.
• Configure CI/CD pipelines (Jenkins, GitHub Actions) to run tests on code commits.
• Fail fast on wait timeouts using ExpectedConditions to catch UI issues early.

Best Practices for Using ExpectedConditions

1. Use Explicit Waits: Always wait for elements or conditions before interacting to avoid flaky tests.
2. Wrap ExpectedConditions: Create utility methods (e.g., WaitUtils.waitForElementVisible(driver, locator)) to reuse waits and improve readability.
3. Avoid Thread.sleep(): Use ExpectedConditions instead of fixed waits for better performance and reliability.
4. Use Specific Conditions: Choose the right condition like visibilityOfElementLocated, elementToBeClickable, or presenceOfElementLocated based on test needs.
5. Set Reasonable Timeouts: Configure explicit wait timeouts to balance test speed and stability.

Self Check

Where in this folder structure would you add a new utility method that waits for an element to be clickable using ExpectedConditions?

Key Result

Use ExpectedConditions in utility classes to implement reliable explicit waits in Selenium Java frameworks.

Practice

1. What is the main purpose of the ExpectedConditions class in Selenium WebDriver?

easy

A. To perform browser navigation actions

B. To locate web elements on the page

C. To wait for certain conditions or states of web elements before proceeding

D. To execute JavaScript code on the page

Solution

1. Step 1: Understand the role of ExpectedConditions

   The ExpectedConditions class provides predefined conditions to wait for, such as visibility or clickability of elements.

2. Step 2: Compare with other Selenium functions

   Locating elements, navigation, and JavaScript execution are handled by other classes or methods, not ExpectedConditions.

3. Final Answer:

   To wait for certain conditions or states of web elements before proceeding -> Option C

4. Quick Check:

   ExpectedConditions = wait for element states [OK]

Hint: ExpectedConditions waits for element states before actions [OK]

Common Mistakes:

• Confusing ExpectedConditions with element locators
• Thinking it performs actions like clicking
• Assuming it runs JavaScript

2. Which of the following is the correct syntax to wait until an element located by By.id("submit") is clickable using ExpectedConditions and WebDriverWait?

easy

A. WebDriverWait(driver, 10).wait(ExpectedConditions.elementToBeClickable(By.id("submit")));

B. new WebDriverWait(driver, 10).until(ExpectedConditions.elementToBeClickable(By.id("submit")));

C. new WebDriverWait(driver, 10).waitFor(ExpectedConditions.elementToBeClickable(By.id("submit")));

D. WebDriverWait(driver, 10).until(ExpectedConditions.elementIsClickable(By.id("submit")));

Solution

1. Step 1: Identify correct WebDriverWait constructor and method

   The correct way is to create a new WebDriverWait object and call the until method.

2. Step 2: Check ExpectedConditions method name

   The method is elementToBeClickable, not elementIsClickable, and the locator is passed correctly.

3. Final Answer:

   new WebDriverWait(driver, 10).until(ExpectedConditions.elementToBeClickable(By.id("submit"))); -> Option B

4. Quick Check:

   Use new WebDriverWait + until + elementToBeClickable [OK]

Hint: Use new WebDriverWait(driver, time).until(condition) [OK]

Common Mistakes:

• Using wait() instead of until()
• Wrong method name like elementIsClickable
• Not creating new WebDriverWait instance

3. Consider the following code snippet:

WebDriverWait wait = new WebDriverWait(driver, 5);
WebElement element = wait.until(ExpectedConditions.visibilityOfElementLocated(By.cssSelector(".login-button")));
element.click();

What happens if the element with class login-button is not visible within 5 seconds?

medium

A. The test passes without clicking the element

B. The code clicks on the element anyway

C. The wait silently ignores and continues without clicking

D. A TimeoutException is thrown and the test fails

Solution

1. Step 1: Understand behavior of WebDriverWait with ExpectedConditions

   If the condition is not met within the timeout, WebDriverWait throws a TimeoutException.

2. Step 2: Analyze the code flow

   Since the element is not visible within 5 seconds, wait.until throws an exception, so element.click() is not executed.

3. Final Answer:

   A TimeoutException is thrown and the test fails -> Option D

4. Quick Check:

   TimeoutException if condition unmet in wait [OK]

Hint: Wait throws TimeoutException if condition unmet [OK]

Common Mistakes:

• Assuming click happens even if element not visible
• Thinking wait ignores failure silently
• Believing test passes without clicking

4. Identify the error in the following code snippet:

WebDriverWait wait = new WebDriverWait(driver, 10);
wait.until(ExpectedConditions.presenceOfElementLocated("#username"));

medium

A. The locator should be a By object, not a String

B. The timeout value should be in milliseconds

C. ExpectedConditions.presenceOfElementLocated does not exist

D. WebDriverWait cannot be used with ExpectedConditions

Solution

1. Step 1: Check the argument type for presenceOfElementLocated

   This method requires a By locator, not a plain string.

2. Step 2: Verify the locator usage

   Instead of passing "#username", it should be By.cssSelector("#username") or another By method.

3. Final Answer:

   The locator should be a By object, not a String -> Option A

4. Quick Check:

   presenceOfElementLocated needs By locator [OK]

Hint: Use By locators, not strings, with ExpectedConditions [OK]

Common Mistakes:

• Passing string selector instead of By object
• Confusing timeout units (seconds vs milliseconds)
• Thinking ExpectedConditions methods don't exist

5. You want to wait until either an element with id loading disappears or a maximum of 15 seconds passes before clicking a button with id continue. Which code snippet correctly uses ExpectedConditions to achieve this?

hard

A. new WebDriverWait(driver, 15).until(ExpectedConditions.invisibilityOfElementLocated(By.id("loading")));
driver.findElement(By.id("continue")).click();

B. new WebDriverWait(driver, 15).until(ExpectedConditions.visibilityOfElementLocated(By.id("loading")));
driver.findElement(By.id("continue")).click();

C. new WebDriverWait(driver, 15).until(ExpectedConditions.elementToBeClickable(By.id("loading")));
driver.findElement(By.id("continue")).click();

D. new WebDriverWait(driver, 15).until(ExpectedConditions.presenceOfElementLocated(By.id("continue")));
driver.findElement(By.id("loading")).click();

Solution

1. Step 1: Identify the condition to wait for

   The requirement is to wait until the element with id "loading" disappears, which matches invisibilityOfElementLocated.

2. Step 2: Confirm the action after wait

   After waiting, the code clicks the button with id "continue" as required.

3. Final Answer:

   new WebDriverWait(driver, 15).until(ExpectedConditions.invisibilityOfElementLocated(By.id("loading"))); driver.findElement(By.id("continue")).click(); -> Option A

4. Quick Check:

   Wait for invisibility, then click continue [OK]

Hint: Wait for invisibilityOfElementLocated before clicking [OK]

Common Mistakes:

• Waiting for visibility instead of invisibility
• Clicking wrong element after wait
• Using presenceOfElementLocated for disappearance