Find element by CSS selector in Selenium Python - Framework Patterns

Framework Mode - Find element by CSS selector

Folder Structure

selenium-python-project/
├── tests/
│   ├── test_login.py
│   └── test_search.py
├── pages/
│   ├── base_page.py
│   └── login_page.py
├── utils/
│   └── helpers.py
├── config/
│   ├── config.yaml
│   └── credentials.yaml
├── conftest.py
└── requirements.txt

Test Framework Layers

• Driver Layer: Manages browser setup and teardown using Selenium WebDriver in conftest.py.
• Page Objects: Classes in pages/ folder encapsulate page elements and actions. Use CSS selectors to find elements.
• Tests: Test scripts in tests/ folder use page objects to perform actions and assertions.
• Utilities: Helper functions in utils/ for reusable code like waits or logging.
• Configuration: Store environment settings and credentials in config/ files.

Configuration Patterns

• Use config/config.yaml to define environment URLs and browser types.
• Store sensitive data like usernames and passwords in config/credentials.yaml, not in code.
• Load configuration in conftest.py to initialize WebDriver with chosen browser and base URL.
• Use command line options or environment variables to switch environments (e.g., dev, staging, prod).

Test Reporting and CI/CD Integration

• Use pytest as test runner with built-in reporting.
• Generate HTML reports with pytest-html plugin for easy viewing.
• Integrate tests in CI/CD pipelines (e.g., GitHub Actions, Jenkins) to run on code push.
• Fail tests if elements are not found by CSS selector, providing clear error messages.

Best Practices

• Use meaningful, stable CSS selectors that are unlikely to change often.
• Encapsulate element locators inside page object classes to keep tests clean.
• Use explicit waits to wait for elements located by CSS selector to be visible or clickable.
• Keep selectors simple and avoid overly complex CSS expressions.
• Separate test data and configuration from test code for flexibility.

Self Check

Where in this folder structure would you add a new CSS selector locator for a "Submit" button on the login page?

Key Result

Use Page Object Model with CSS selectors encapsulated in page classes, supported by config and utilities for robust Selenium Python tests.

Practice

1. Which method is used in Selenium Python to find an element by CSS selector?

easy

A. driver.find_element_by_name("selector")

B. driver.find_element(By.CSS_SELECTOR, "selector")

C. driver.find_element_by_xpath("selector")

D. driver.find_element_by_id("selector")

Solution

1. Step 1: Understand Selenium element finding methods

   Selenium provides different methods to find elements, including by ID, name, XPath, and CSS selector.

2. Step 2: Identify the correct method for CSS selector

   The method to find by CSS selector is driver.find_element(By.CSS_SELECTOR, "selector").

3. Final Answer:

   driver.find_element(By.CSS_SELECTOR, "selector") -> Option B

4. Quick Check:

   Find element by CSS selector = driver.find_element(By.CSS_SELECTOR, "selector") [OK]

Hint: Use By.CSS_SELECTOR with find_element for CSS selectors [OK]

Common Mistakes:

• Using find_element_by_id for CSS selectors
• Confusing XPath with CSS selector method
• Using deprecated find_element_by_* methods

2. Which of the following is the correct syntax to find an element with class name "btn-primary" using CSS selector in Selenium Python?

easy

A. driver.find_element(By.CSS_SELECTOR, ".btn-primary")

B. driver.find_element(By.CSS_SELECTOR, "#btn-primary")

C. driver.find_element(By.CSS_SELECTOR, "btn-primary")

D. driver.find_element(By.CSS_SELECTOR, "*btn-primary")

Solution

1. Step 1: Recall CSS selector for class names

   In CSS selectors, a class is selected by prefixing the class name with a dot (.)

2. Step 2: Match the correct syntax

   To select class "btn-primary", use ".btn-primary" inside find_element.

3. Final Answer:

   driver.find_element(By.CSS_SELECTOR, ".btn-primary") -> Option A

4. Quick Check:

   Class selector = .classname [OK]

Hint: Use dot (.) before class name in CSS selector [OK]

Common Mistakes:

• Using # instead of . for class selectors
• Omitting the dot before class name
• Using invalid wildcard * before class name

3. What will the following Selenium Python code select?

element = driver.find_element(By.CSS_SELECTOR, "div#main > ul.items > li.active")

medium

A. The first <li> element with class 'active' inside <ul> with class 'items' inside <div> with id 'main'

B. All <li> elements inside any <ul> inside any <div>

C. The <div> element with id 'main' only

D. The <ul> element with class 'items' only

Solution

1. Step 1: Break down the CSS selector

   The selector targets a
2. element with class 'active' that is a direct child of a <ul> with class 'items', which is a direct child of a <div> with id 'main'.

3. Step 2: Understand the element selected

   It selects the first matching
4. element with class 'active' inside the specified structure.

5. Final Answer:

   The first <li> element with class 'active' inside <ul> with class 'items' inside <div> with id 'main' -> Option A

6. Quick Check:

   CSS selector matches nested elements exactly [OK]

Hint: Read CSS selector from right to left for nested elements [OK]

Common Mistakes:

• Thinking it selects all <li> elements, not just with class 'active'
• Ignoring the direct child (>) combinators
• Confusing id (#) and class (.) selectors

4. Identify the error in this Selenium Python code snippet:

element = driver.find_element(By.CSS_SELECTOR, "#content .item[active]")

medium

A. The ID selector #content should be a class selector

B. The method find_element does not accept CSS selectors

C. The CSS selector should use double quotes inside single quotes

D. The attribute selector [active] is missing an equals sign and value

Solution

1. Step 1: Analyze the attribute selector syntax

   The selector uses [active] which means attribute 'active' must be present, but usually attributes require a value like [active="true"].

2. Step 2: Identify the correct attribute selector format

   To check for attribute presence only, [active] is valid, but if a value is expected, it must be [active="value"]. Here, likely a value is missing.

3. Final Answer:

   The attribute selector [active] is missing an equals sign and value -> Option D

4. Quick Check:

   Attribute selectors need correct syntax [OK]

Hint: Attribute selectors need = and value unless checking presence only [OK]

Common Mistakes:

• Assuming [active] always works without value
• Confusing ID (#) and class (.) selectors
• Using wrong quotes inside CSS selector string

5. You want to find all <input> elements inside a form with id "loginForm" that have both classes "input-field" and "required". Which CSS selector should you use with Selenium Python's find_elements method?

hard

A. "form#loginForm input#input-field#required"

B. "form#loginForm input .input-field .required"

C. "form#loginForm input.input-field.required"

D. "form#loginForm > input > .input-field > .required"

Solution

1. Step 1: Understand CSS selector for multiple classes

   To select elements with multiple classes, chain class selectors without spaces, e.g., .input-field.required.

2. Step 2: Combine with tag and parent selectors

   Use form#loginForm to select the form by id, then space to select descendants, then input.input-field.required for inputs with both classes.

3. Final Answer:

   "form#loginForm input.input-field.required" -> Option C

4. Quick Check:

   Multiple classes chained without spaces [OK]

Hint: Chain multiple classes without spaces in CSS selector [OK]

Common Mistakes:

• Adding spaces between multiple classes (selects descendants instead)
• Using multiple IDs on one element (invalid)
• Using child combinator (>) incorrectly for nested elements