Selenium components (WebDriver, Grid, IDE) in Selenium Python - Framework Patterns

Framework Mode - Selenium components (WebDriver, Grid, IDE)

Folder Structure of a Selenium Python Test Project

selenium-python-project/
├── tests/
│   ├── test_login.py
│   ├── test_search.py
│   └── __init__.py
├── pages/
│   ├── login_page.py
│   ├── search_page.py
│   └── __init__.py
├── utils/
│   ├── driver_factory.py
│   ├── config_reader.py
│   └── __init__.py
├── resources/
│   ├── config.yaml
│   └── test_data.json
├── reports/
│   └── latest_report.html
├── conftest.py
├── requirements.txt
└── README.md
  

Test Framework Layers

• Driver Layer: Manages WebDriver instances for browsers. Uses driver_factory.py to create WebDriver objects (local or remote via Selenium Grid).
• Page Objects: Classes representing web pages (e.g., login_page.py). Encapsulate locators and actions for UI elements.
• Test Layer: Contains test scripts (e.g., test_login.py) that use page objects and driver layer to perform test scenarios.
• Utilities: Helper modules like configuration readers, logging, and data handling.
• Configuration: Files like config.yaml hold environment settings, browser choices, and credentials.

Configuration Patterns

Use a config.yaml file to store environment URLs, browser types, Selenium Grid hub URL, and credentials.

# Example config.yaml
environment: "staging"
browser: "chrome"
grid_url: "http://localhost:4444/wd/hub"
credentials:
  username: "testuser"
  password: "password123"
  

Load this config in config_reader.py and pass settings to driver_factory.py to create local or remote WebDriver instances.

Test Reporting and CI/CD Integration

• Use pytest with plugins like pytest-html to generate readable HTML reports saved in reports/.
• Integrate tests in CI/CD pipelines (e.g., GitHub Actions, Jenkins) to run tests on code changes automatically.
• Configure Selenium Grid to run tests in parallel on multiple browsers and machines, speeding up test execution.

Best Practices for Selenium Framework

• Use Page Object Model: Keep locators and page actions in separate classes to improve maintainability.
• Explicit Waits: Use Selenium explicit waits to handle dynamic page elements instead of fixed sleeps.
• Data-Driven Testing: Separate test data from test scripts using JSON or YAML files.
• Use Selenium Grid: Run tests in parallel on different browsers and machines to save time.
• Keep Tests Independent: Each test should set up and clean up its own state to avoid flaky tests.

Self Check Question

Where in this folder structure would you add a new page object class for the "Dashboard" page?

Key Result

Organize Selenium tests using Page Object Model, driver management, config files, and parallel execution with Selenium Grid.

Practice

1. Which Selenium component allows you to write test scripts in programming languages like Python?

easy

A. WebDriver

B. Grid

C. IDE

D. Selenium Server

Solution

1. Step 1: Understand Selenium components

   WebDriver is the part of Selenium that lets you write code to control browsers.

2. Step 2: Match component to functionality

   Grid is for running tests in parallel, IDE is for recording tests, so only WebDriver fits writing code tests.

3. Final Answer:

   WebDriver -> Option A

4. Quick Check:

   Write tests in code = WebDriver [OK]

Hint: Code tests? Think WebDriver [OK]

Common Mistakes:

• Confusing Grid with writing code
• Thinking IDE is for coding tests
• Selecting Selenium Server which is not a main component

2. Which of the following is the correct way to start a Chrome WebDriver session in Python?

easy

A. driver = webdriver.start('chrome')

B. driver = webdriver.Chrome()

C. driver = ChromeDriver()

D. driver = webdriver.open('chrome')

Solution

1. Step 1: Recall Selenium Python syntax

   The standard way to start Chrome WebDriver is using webdriver.Chrome() constructor.

2. Step 2: Check other options for syntax errors

   Options A, C, and D use incorrect method names or classes not defined in Selenium Python.

3. Final Answer:

   driver = webdriver.Chrome() -> Option B

4. Quick Check:

   Correct constructor = webdriver.Chrome() [OK]

Hint: Use webdriver.Chrome() to start Chrome [OK]

Common Mistakes:

• Using undefined methods like start() or open()
• Trying to instantiate ChromeDriver directly
• Missing webdriver prefix

3. What will be the output of the following Python Selenium code snippet?

from selenium import webdriver
from selenium.webdriver.common.by import By

driver = webdriver.Chrome()
driver.get('https://example.com')
element = driver.find_element(By.ID, 'submit')
print(element.tag_name)

medium

A. NoSuchElementException

B. submit

C. id

D. button

Solution

1. Step 1: Understand the code behavior

   The code opens example.com and tries to find an element with ID 'submit'.

2. Step 2: Check the target page

   The example.com page does not contain an element with id='submit', so driver.find_element raises NoSuchElementException before the print statement executes.

3. Final Answer:

   NoSuchElementException -> Option A

4. Quick Check:

   No element on page = NoSuchElementException [OK]

Hint: Verify element exists on the actual page [OK]

Common Mistakes:

• Assuming example.com has id='submit'
• Confusing element ID with tag name
• Expecting print to run despite missing element

4. You want to run tests on multiple machines at the same time using Selenium. You wrote this code but tests run only on one machine. What is missing?

from selenium import webdriver

options = webdriver.ChromeOptions()
driver = webdriver.Chrome(options=options)
driver.get('https://example.com')

medium

A. You must use webdriver.Firefox() instead

B. You forgot to import Selenium Grid module

C. You need to configure Selenium Grid and connect to it

D. You should use Selenium IDE for parallel tests

Solution

1. Step 1: Identify the problem context

   The code runs tests on one machine only, but the goal is parallel testing on multiple machines.

2. Step 2: Understand Selenium Grid role

   Selenium Grid allows running tests on many machines simultaneously. The code must connect to the Grid hub to distribute tests.

3. Final Answer:

   You need to configure Selenium Grid and connect to it -> Option C

4. Quick Check:

   Parallel tests require Selenium Grid setup [OK]

Hint: Parallel tests need Selenium Grid connection [OK]

Common Mistakes:

• Assuming importing a module enables Grid
• Switching browsers does not enable parallelism
• Using IDE instead of Grid for parallel runs

5. You want to record a test quickly without coding and then export it to Python WebDriver code. Which Selenium component should you use?

hard

A. Selenium Server

B. Selenium Grid

C. Selenium WebDriver

D. Selenium IDE

Solution

1. Step 1: Identify the requirement

   The user wants to record tests without writing code and export to Python WebDriver code.

2. Step 2: Match Selenium component to feature

   Selenium IDE is a browser plugin that records user actions and can export recorded tests to code in various languages including Python WebDriver.

3. Final Answer:

   Selenium IDE -> Option D

4. Quick Check:

   Record tests and export code = Selenium IDE [OK]

Hint: Record tests visually? Use Selenium IDE [OK]

Common Mistakes:

• Confusing Grid with recording tests
• Thinking WebDriver records tests
• Assuming Selenium Server handles recording