Expected conditions in Selenium Python

Introduction

Expected conditions help your test wait for things on a web page to be ready before checking them. This stops errors caused by trying to use parts of the page too early.

Waiting for a button to appear before clicking it.

Checking if a text message shows up after submitting a form.

Waiting for a page to load before reading its title.

Ensuring an element is visible before interacting with it.

Waiting for a URL to change after clicking a link.

Syntax

Selenium Python

from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC

wait = WebDriverWait(driver, timeout_in_seconds)
wait.until(EC.condition(locator))

WebDriverWait waits for a maximum time for a condition to be true.

EC.condition(locator) is the expected condition you want to check, like visibility or clickability.

Examples

Wait until the element with ID 'submit-button' is visible on the page.

Selenium Python

wait.until(EC.visibility_of_element_located((By.ID, 'submit-button')))

Wait until the element with class 'btn-primary' can be clicked.

Selenium Python

wait.until(EC.element_to_be_clickable((By.CSS_SELECTOR, '.btn-primary')))

Wait until the current URL contains the word 'dashboard'.

Selenium Python

wait.until(EC.url_contains('dashboard'))

Sample Program

This script opens example.com, waits up to 10 seconds for the main heading (h1) to appear, then prints its text. It closes the browser after.

Selenium Python

from selenium import webdriver
from selenium.webdriver.common.by import By
from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC

# Setup driver (make sure chromedriver is in PATH)
driver = webdriver.Chrome()

try:
    driver.get('https://example.com')
    wait = WebDriverWait(driver, 10)

    # Wait for the heading to be visible
    heading = wait.until(EC.visibility_of_element_located((By.TAG_NAME, 'h1')))

    print('Heading text:', heading.text)

finally:
    driver.quit()

Important Notes

Always use tuples like (By.ID, 'value') as locators inside expected conditions.

Set a reasonable timeout to avoid waiting too long or too short.

Expected conditions help make tests more reliable by syncing with the page state.

Summary

Expected conditions wait for specific page states before continuing.

Use WebDriverWait with EC to avoid errors from elements not ready yet.

Common conditions include visibility, clickability, and URL changes.

Practice

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

easy

A. To wait for certain conditions before interacting with elements

B. To speed up the test execution by skipping waits

C. To generate random test data automatically

D. To take screenshots during test execution

Solution

1. Step 1: Understand ExpectedConditions role

   ExpectedConditions help Selenium wait for specific states like element visibility or clickability before proceeding.

2. Step 2: Identify the main purpose

   This waiting avoids errors caused by trying to interact with elements not yet ready on the page.

3. Final Answer:

   To wait for certain conditions before interacting with elements -> Option A

4. Quick Check:

   ExpectedConditions = Wait for conditions [OK]

Hint: ExpectedConditions = smart waits before actions [OK]

Common Mistakes:

• Thinking ExpectedConditions speed up tests by skipping waits
• Confusing ExpectedConditions with data generation
• Assuming ExpectedConditions take screenshots

2. Which of the following is the correct syntax to wait until an element located by ID 'submit' is clickable using Selenium's ExpectedConditions in Python?

easy

A. WebDriverWait(driver, 10).until(EC.visibility_of_element_located('submit'))

B. WebDriverWait(driver, 10).until(EC.element_to_be_clickable((By.ID, 'submit')))

C. WebDriverWait(driver, 10).until(EC.element_to_be_clickable('submit'))

D. WebDriverWait(driver, 10).until(EC.presence_of_element_located(By.ID, 'submit'))

Solution

1. Step 1: Check correct ExpectedCondition usage

   element_to_be_clickable requires a locator tuple like (By.ID, 'submit').

2. Step 2: Verify syntax correctness

   WebDriverWait(driver, 10).until(EC.element_to_be_clickable((By.ID, 'submit'))) correctly uses a tuple inside the condition and waits properly.

3. Final Answer:

   WebDriverWait(driver, 10).until(EC.element_to_be_clickable((By.ID, 'submit'))) -> Option B

4. Quick Check:

   Use tuple locator with element_to_be_clickable [OK]

Hint: Use (By.ID, 'id') tuple inside ExpectedConditions [OK]

Common Mistakes:

• Passing string instead of locator tuple
• Using visibility_of_element_located instead of clickable
• Missing parentheses around locator tuple

3. What will be the output of the following code snippet if the element with ID 'login' becomes visible after 5 seconds?

from selenium.webdriver.common.by import By
from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC

wait = WebDriverWait(driver, 10)
element = wait.until(EC.visibility_of_element_located((By.ID, 'login')))
print(element.is_displayed())

medium

A. TimeoutException

B. False

C. True

D. NoSuchElementException

Solution

1. Step 1: Analyze wait duration and element visibility

   The wait is 10 seconds, and the element appears after 5 seconds, so wait.until succeeds.

2. Step 2: Understand is_displayed() output

   Since the element is visible, element.is_displayed() returns True, which is printed.

3. Final Answer:

   True -> Option C

4. Quick Check:

   Element visible within wait = True output [OK]

Hint: If element appears before timeout, is_displayed() is True [OK]

Common Mistakes:

• Expecting TimeoutException though element appears in time
• Confusing is_displayed() with presence only
• Assuming False if element appears late but within wait

4. Identify the error in the following code that waits for an element with class name 'btn' to be clickable:

wait = WebDriverWait(driver, 5)
wait.until(EC.element_to_be_clickable(By.CLASS_NAME, 'btn'))

medium

A. Timeout value too low

B. Incorrect import of WebDriverWait

C. Using CLASS_NAME instead of CSS_SELECTOR

D. Missing tuple around locator in element_to_be_clickable

Solution

1. Step 1: Check element_to_be_clickable parameter

   It requires a single locator tuple like (By.CLASS_NAME, 'btn'), not two separate arguments.

2. Step 2: Identify syntax error

   Code passes two arguments instead of one tuple, causing a TypeError.

3. Final Answer:

   Missing tuple around locator in element_to_be_clickable -> Option D

4. Quick Check:

   Locator must be a tuple inside ExpectedConditions [OK]

Hint: Always wrap locator in a tuple for ExpectedConditions [OK]

Common Mistakes:

• Passing locator arguments separately instead of tuple
• Assuming timeout value causes error here
• Confusing locator types (CLASS_NAME vs CSS_SELECTOR)

5. You want to wait until the URL contains the word 'dashboard' before proceeding. Which code snippet correctly uses ExpectedConditions to achieve this in Python Selenium?

hard

A. WebDriverWait(driver, 15).until(EC.url_contains('dashboard'))

B. WebDriverWait(driver, 15).until(EC.url_to_be('dashboard'))

C. WebDriverWait(driver, 15).until(EC.url_matches('dashboard'))

D. WebDriverWait(driver, 15).until(EC.url_is('dashboard'))

Solution

1. Step 1: Identify correct ExpectedCondition for URL substring

   EC.url_contains waits until the URL contains the given substring.

2. Step 2: Verify other options

   url_matches requires a regex pattern to match the entire URL, url_to_be checks for exact URL equality, and url_is is not a valid ExpectedCondition.

3. Final Answer:

   WebDriverWait(driver, 15).until(EC.url_contains('dashboard')) -> Option A

4. Quick Check:

   Use url_contains for substring in URL [OK]

Hint: Use EC.url_contains for partial URL waits [OK]

Common Mistakes:

• Using non-existent ExpectedConditions like url_is
• Confusing url_contains with exact match conditions like url_to_be
• Using url_matches without proper regex for substring