Fluent waits in Selenium Python - Framework Patterns

Framework Mode - Fluent waits

Folder Structure

selenium_python_project/
├── tests/
│   ├── test_login.py
│   ├── test_search.py
│   └── test_checkout.py
├── pages/
│   ├── base_page.py
│   ├── login_page.py
│   └── search_page.py
├── utils/
│   ├── wait_utils.py
│   └── logger.py
├── config/
│   ├── config.yaml
│   └── credentials.yaml
├── conftest.py
└── requirements.txt
    

Test Framework Layers

• Driver Layer: Manages WebDriver setup and teardown (in conftest.py using pytest fixtures).
• Page Objects: Classes representing web pages with methods to interact with elements (in pages/).
• Wait Utilities: Contains fluent wait implementations to wait for elements with polling and timeout (in utils/wait_utils.py).
• Tests: Test cases using pytest that call page objects and wait utilities (in tests/).
• Configuration: Stores environment settings, URLs, credentials (in config/).
• Logging & Helpers: Utility functions like logging to track test execution (in utils/logger.py).

Configuration Patterns

Use YAML files in config/ to store environment variables, browser types, and credentials.

Load these configs in conftest.py to initialize WebDriver accordingly.

Example snippet in conftest.py:

import yaml
import pytest
from selenium import webdriver

@pytest.fixture(scope='session')
def config():
    with open('config/config.yaml') as f:
        return yaml.safe_load(f)

@pytest.fixture(scope='function')
def driver(config):
    browser = config.get('browser', 'chrome')
    if browser == 'chrome':
        driver = webdriver.Chrome()
    else:
        driver = webdriver.Firefox()
    driver.maximize_window()
    yield driver
    driver.quit()
    

Test Reporting and CI/CD Integration

• Use pytest with pytest-html plugin to generate HTML reports after test runs.
• Integrate with CI/CD tools like GitHub Actions or Jenkins to run tests on code push.
• Configure CI to install dependencies, run tests, and publish reports automatically.
• Example GitHub Actions step runs tests and uploads report as artifact.

Best Practices for Fluent Waits Framework

• Centralize Wait Logic: Put fluent wait code in utility functions to reuse and maintain easily.
• Use Explicit Polling: Fluent waits poll at intervals until condition met or timeout, avoiding fixed sleeps.
• Handle Exceptions Gracefully: Ignore exceptions like NoSuchElementException during wait polling.
• Keep Page Objects Clean: Page objects call wait utilities instead of embedding wait code directly.
• Parameterize Waits: Allow timeout and polling interval to be configurable for flexibility.

Self Check Question

Where in this folder structure would you add a new fluent wait function to wait for an element's visibility with custom polling?

Key Result

Organize fluent waits in utility modules to enable reusable, configurable, and robust element waiting in Selenium Python tests.

Practice

1. What is the main purpose of using a FluentWait in Selenium Python?

easy

A. To pause the test execution for a fixed time

B. To repeatedly check for a condition until it is met or a timeout occurs

C. To immediately find an element without waiting

D. To run tests in parallel threads

Solution

1. Step 1: Understand FluentWait behavior

   FluentWait repeatedly checks for a condition, like element presence, until timeout or success.

2. Step 2: Compare options

   Only To repeatedly check for a condition until it is met or a timeout occurs describes this repeated checking with timeout. Others describe different concepts.

3. Final Answer:

   To repeatedly check for a condition until it is met or a timeout occurs -> Option B

4. Quick Check:

   FluentWait = repeated checks with timeout [OK]

Hint: FluentWait keeps trying until success or timeout [OK]

Common Mistakes:

• Confusing FluentWait with fixed sleep
• Thinking FluentWait runs tests in parallel
• Assuming FluentWait finds elements instantly

2. Which of the following is the correct way to create a FluentWait object in Selenium Python?

easy

A. wait = FluentWait(driver).with_timeout(10).polling_every(1).ignoring(NoSuchElementException)

B. wait = FluentWait(driver, timeout=10, poll_interval=1, ignored_exceptions=[NoSuchElementException])

C. wait = WebDriverWait(driver, 10).pollingEvery(1).ignoring(NoSuchElementException)

D. wait = FluentWait(driver).timeout(10).poll(1).ignore(NoSuchElementException)

Solution

1. Step 1: Recall FluentWait syntax in Selenium Python

   The correct syntax chains methods: with_timeout(), polling_every(), ignoring() on FluentWait instance.

2. Step 2: Analyze options

   wait = FluentWait(driver).with_timeout(10).polling_every(1).ignoring(NoSuchElementException) matches correct chaining syntax. wait = FluentWait(driver, timeout=10, poll_interval=1, ignored_exceptions=[NoSuchElementException]) uses wrong constructor parameters. wait = WebDriverWait(driver, 10).pollingEvery(1).ignoring(NoSuchElementException) uses WebDriverWait, not FluentWait. wait = FluentWait(driver).timeout(10).poll(1).ignore(NoSuchElementException) uses incorrect method names.

3. Final Answer:

   wait = FluentWait(driver).with_timeout(10).polling_every(1).ignoring(NoSuchElementException) -> Option A

4. Quick Check:

   FluentWait chaining methods = wait = FluentWait(driver).with_timeout(10).polling_every(1).ignoring(NoSuchElementException) [OK]

Hint: FluentWait uses chained methods like with_timeout() [OK]

Common Mistakes:

• Using WebDriverWait instead of FluentWait
• Passing parameters directly to constructor
• Using wrong method names like timeout()

3. What will be the output of the following code snippet if the element with id 'submit' appears after 3 seconds?

from selenium.webdriver.support.ui import FluentWait
from selenium.common.exceptions import NoSuchElementException

wait = FluentWait(driver).with_timeout(5).polling_every(1).ignoring(NoSuchElementException)
element = wait.until(lambda d: d.find_element('id', 'submit'))
print(element.tag_name)

medium

A. Raises NoSuchElementException after 5 seconds

B. Raises TimeoutException immediately

C. Prints the tag name of the 'submit' element after about 3 seconds

D. Prints None immediately

Solution

1. Step 1: Understand FluentWait timing

   FluentWait waits up to 5 seconds, checking every 1 second, ignoring NoSuchElementException.

2. Step 2: Analyze element appearance

   The element appears after 3 seconds, which is within the 5-second timeout, so wait.until returns the element.

3. Step 3: Print element tag name

   After wait.until returns, print outputs the tag name of the found element.

4. Final Answer:

   Prints the tag name of the 'submit' element after about 3 seconds -> Option C

5. Quick Check:

   Element found within timeout = prints tag name [OK]

Hint: FluentWait waits until element appears or timeout [OK]

Common Mistakes:

• Expecting immediate TimeoutException
• Thinking NoSuchElementException is raised
• Assuming print outputs None

4. Identify the error in this FluentWait usage:

wait = FluentWait(driver).with_timeout(10).polling_every(2)
element = wait.until(lambda d: d.find_element_by_id('login'))

medium

A. Using deprecated method find_element_by_id instead of find_element

B. Missing ignoring() to handle exceptions

C. Polling interval is too long

D. Timeout value should be in milliseconds

Solution

1. Step 1: Check method usage for element finding

   In Selenium Python 3.12+, find_element_by_id is deprecated; use find_element('id', 'login').

2. Step 2: Review other options

   Ignoring exceptions is optional but recommended; polling_every uses seconds; timeout is in seconds, so no error there.

3. Final Answer:

   Using deprecated method find_element_by_id instead of find_element -> Option A

4. Quick Check:

   Deprecated method usage = Using deprecated method find_element_by_id instead of find_element [OK]

Hint: Use find_element with locator tuple, not deprecated methods [OK]

Common Mistakes:

• Ignoring deprecation warnings
• Confusing polling interval units
• Assuming timeout needs milliseconds

5. You want to wait for a button with CSS selector '.submit-btn' to be clickable, checking every 500 milliseconds, with a timeout of 8 seconds, ignoring ElementNotInteractableException. Which FluentWait code snippet correctly implements this?

hard

A. wait = FluentWait(driver).with_timeout(8).polling_every(0.5).ignoring(ElementNotInteractableException)
element = wait.until(lambda d: d.find_element('css selector', '.submit-btn').is_enabled())

B. wait = FluentWait(driver).with_timeout(8).polling_every(0.5).ignoring(ElementNotInteractableException)
element = wait.until(lambda d: d.find_element_by_css_selector('.submit-btn').is_enabled())

C. wait = FluentWait(driver).with_timeout(8).polling_every(0.5).ignoring(ElementNotInteractableException)
element = wait.until(lambda d: d.find_element('css selector', '.submit-btn').clickable())

D. wait = FluentWait(driver).with_timeout(8).polling_every(0.5).ignoring(ElementNotInteractableException)
element = wait.until(lambda d: d.find_element('css selector', '.submit-btn') if d.find_element('css selector', '.submit-btn').is_enabled() else False)

Solution

1. Step 1: Set FluentWait with correct timeout, polling, and ignoring

   All options set timeout 8s, polling 0.5s, ignoring ElementNotInteractableException correctly.

2. Step 2: Check lambda condition for clickable

   wait = FluentWait(driver).with_timeout(8).polling_every(0.5).ignoring(ElementNotInteractableException) element = wait.until(lambda d: d.find_element('css selector', '.submit-btn') if d.find_element('css selector', '.submit-btn').is_enabled() else False) returns the element only if is_enabled() is True; else returns False to keep waiting. This is correct usage.

3. Step 3: Identify errors in other options

   wait = FluentWait(driver).with_timeout(8).polling_every(0.5).ignoring(ElementNotInteractableException) element = wait.until(lambda d: d.find_element('css selector', '.submit-btn').is_enabled()) returns boolean from is_enabled(), not element; wait = FluentWait(driver).with_timeout(8).polling_every(0.5).ignoring(ElementNotInteractableException) element = wait.until(lambda d: d.find_element('css selector', '.submit-btn').clickable()) uses non-existent clickable() method; wait = FluentWait(driver).with_timeout(8).polling_every(0.5).ignoring(ElementNotInteractableException) element = wait.until(lambda d: d.find_element_by_css_selector('.submit-btn').is_enabled()) uses deprecated find_element_by_css_selector.

4. Final Answer:

   wait = FluentWait(driver).with_timeout(8).polling_every(0.5).ignoring(ElementNotInteractableException)\nelement = wait.until(lambda d: d.find_element('css selector', '.submit-btn') if d.find_element('css selector', '.submit-btn').is_enabled() else False) -> Option D

5. Quick Check:

   Return element only when clickable = wait = FluentWait(driver).with_timeout(8).polling_every(0.5).ignoring(ElementNotInteractableException)\nelement = wait.until(lambda d: d.find_element('css selector', '.submit-btn') if d.find_element('css selector', '.submit-btn').is_enabled() else False) [OK]

Hint: Return element only when condition true inside wait.until lambda [OK]

Common Mistakes:

• Returning boolean instead of element in wait.until
• Using deprecated find_element_by_css_selector
• Calling non-existent clickable() method