Why mastering selectors ensures reliability in Selenium Python - Test Execution Impact

Test Overview

This test opens a simple web page, finds a button using a CSS selector, clicks it, and verifies the button's text changes. It shows how using a precise selector ensures the test finds the right element and works reliably.

Test Code - Selenium

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
import unittest

class TestButtonClick(unittest.TestCase):
    def setUp(self):
        self.driver = webdriver.Chrome()
        self.driver.get('https://example.com/testpage')

    def test_button_click_changes_text(self):
        driver = self.driver
        # Wait until button is present using a precise CSS selector
        button = WebDriverWait(driver, 10).until(
            EC.presence_of_element_located((By.CSS_SELECTOR, 'button#submit-btn.primary'))
        )
        button.click()
        # Verify the button text changed after click
        changed_text = WebDriverWait(driver, 10).until(
            EC.text_to_be_present_in_element((By.CSS_SELECTOR, 'button#submit-btn.primary'), 'Clicked')
        )
        self.assertTrue(changed_text)

    def tearDown(self):
        self.driver.quit()

if __name__ == '__main__':
    unittest.main()

Execution Trace - 6 Steps

Step	Action	System State	Assertion	Result
1	Test starts and Chrome browser opens	Browser window is open and ready	—	PASS
2	Browser navigates to https://example.com/testpage	Page loads with a button having id 'submit-btn' and class 'primary'	—	PASS
3	Waits until button with CSS selector 'button#submit-btn.primary' is present	Button is found on the page	Element located by CSS selector exists	PASS
4	Clicks the button	Button is clicked, triggering text change	—	PASS
5	Waits until button text changes to include 'Clicked'	Button text updates to 'Clicked' or similar	Button text contains 'Clicked'	PASS
6	Test ends and browser closes	Browser window closes	—	PASS

Failure Scenario

Failing Condition: The CSS selector is incorrect or the button does not exist with that selector

Execution Trace Quiz - 3 Questions

What does the test verify after clicking the button?

A A new page loads

B The button disappears from the page

C The button's text changes to include 'Clicked'

D The button's color changes

Key Result

Mastering selectors ensures tests find the right elements reliably, preventing failures caused by incorrect or ambiguous locators.

Practice

1. Why is it important to use unique and stable selectors in Selenium tests?

easy

A. Because they make tests more reliable and less likely to break

B. Because they make tests run slower

C. Because they increase the number of test cases

D. Because they reduce the number of browsers supported

Solution

1. Step 1: Understand the role of selectors in Selenium

   Selectors help Selenium find elements on a webpage to interact with during tests.

2. Step 2: Identify the impact of selector quality

   Unique and stable selectors ensure the test finds the correct element every time, preventing failures due to changes in the page.

3. Final Answer:

   Because they make tests more reliable and less likely to break -> Option A

4. Quick Check:

   Reliable selectors = stable tests [OK]

Hint: Pick selectors that rarely change to keep tests stable [OK]

Common Mistakes:

• Using selectors that rely on dynamic or changing attributes
• Choosing selectors that match multiple elements
• Ignoring the importance of unique identifiers

2. Which of the following is the correct syntax to find an element by its ID using Selenium in Python?

easy

A. driver.find_element(By.id, "username")

B. driver.find_element(By.Id, "username")

C. driver.find_element(By.ID, "username")

D. driver.find_element_by_id("username")

Solution

1. Step 1: Recall the correct Selenium syntax for finding elements by ID

   In Selenium Python 4+, the correct syntax uses By.ID with uppercase 'ID'.

2. Step 2: Compare options for case sensitivity and method usage

   driver.find_element(By.ID, "username") uses By.ID correctly; driver.find_element(By.id, "username") uses lowercase 'id' which is incorrect; driver.find_element_by_id("username") uses deprecated method; driver.find_element(By.Id, "username") uses incorrect case 'Id'.

3. Final Answer:

   driver.find_element(By.ID, "username") -> Option C

4. Quick Check:

   Use By.ID with uppercase for ID selectors [OK]

Hint: Use By.ID in uppercase for ID selectors in Selenium Python [OK]

Common Mistakes:

• Using deprecated methods like find_element_by_id
• Incorrect casing in By.ID
• Passing By.id instead of By.ID

3. Given the following HTML snippet:

<button class="btn primary" id="submit-btn">Submit</button>

Which selector will reliably find the button element in Selenium?

medium

A. driver.find_element(By.ID, "submit-btn")

B. driver.find_element(By.CLASS_NAME, "btn")

C. driver.find_element(By.TAG_NAME, "button")

D. driver.find_element(By.CSS_SELECTOR, ".primary")

Solution

1. Step 1: Analyze the uniqueness of each selector

   ID "submit-btn" is unique and stable, class "btn" or "primary" may be shared, and tag "button" is generic.

2. Step 2: Determine the most reliable selector

   Using By.ID with "submit-btn" ensures the exact button is found reliably.

3. Final Answer:

   driver.find_element(By.ID, "submit-btn") -> Option A

4. Quick Check:

   Unique ID selector = reliable element find [OK]

Hint: Use unique IDs over classes or tags for stable element selection [OK]

Common Mistakes:

• Using class selectors that match multiple elements
• Using tag selectors that are too generic
• Ignoring unique IDs when available

4. You wrote this Selenium code but it fails to find the element:

driver.find_element(By.CSS_SELECTOR, "#login button")

What is the likely problem?

medium

A. The method find_element should be find_elements

B. The CSS selector is incorrect because it looks for a button inside an element with id 'login', which might not exist

C. The By.CSS_SELECTOR should be By.CSS

D. The selector should use a class instead of an ID

Solution

1. Step 1: Understand the CSS selector meaning

   The selector "#login button" looks for a button inside an element with id 'login'. If such structure doesn't exist, it fails.

2. Step 2: Check other options for correctness

   find_element is correct for single element; By.CSS_SELECTOR is correct; using class instead of ID is unrelated to the error.

3. Final Answer:

   The CSS selector is incorrect because it looks for a button inside an element with id 'login', which might not exist -> Option B

4. Quick Check:

   Selector must match actual page structure [OK]

Hint: Verify page structure matches your CSS selector path [OK]

Common Mistakes:

• Using wrong By constants like By.CSS
• Confusing find_element with find_elements
• Assuming element hierarchy without checking HTML

5. You want to select all visible buttons with the class 'action' but avoid hidden ones. Which Selenium selector strategy ensures reliability?

hard

A. Use class name selector "action" only

B. Use XPath "//button[contains(@class, 'action') and not(contains(@style, 'display:none'))]"

C. Use tag name selector "button" only

D. Use CSS selector "button.action" and then filter elements by checking visibility in code

Solution

1. Step 1: Understand selector limitations for visibility

   CSS selectors cannot directly filter visible elements; visibility must be checked in code after selection.

2. Step 2: Evaluate each option's reliability

   Use CSS selector "button.action" and then filter elements by checking visibility in code selects all buttons with class 'action' and filters visibility in code, ensuring reliability. Use XPath "//button[contains(@class, 'action') and not(contains(@style, 'display:none'))]" tries to filter by style attribute which may not cover all hidden cases. Options A and D are too broad.

3. Final Answer:

   Use CSS selector "button.action" and then filter elements by checking visibility in code -> Option D

4. Quick Check:

   Filter visibility in code after selecting by stable CSS selector [OK]

Hint: Select by class, then check visibility in code for reliable filtering [OK]

Common Mistakes:

• Relying on CSS or XPath to filter visibility only
• Using too broad selectors causing false matches
• Ignoring dynamic visibility changes in tests