CSS selector syntax in Selenium Java - Framework Patterns

Framework Mode - CSS selector syntax

Folder Structure for Selenium Java Framework

selenium-java-framework/
├── src/
│   ├── main/
│   │   └── java/
│   │       └── com/example/pages/       # Page Object classes
│   └── test/
│       └── java/
│           └── com/example/tests/       # Test classes
├── resources/
│   └── testdata/                        # Test data files (CSV, JSON)
├── drivers/                            # Browser driver executables
├── pom.xml                            # Maven build and dependency file
└── testng.xml                        # TestNG suite configuration
    

Test Framework Layers

• Driver Layer: Manages WebDriver setup and teardown for browsers.
• Page Objects: Classes representing web pages with CSS selectors locating elements.
• Tests: TestNG test classes using page objects and assertions.
• Utilities: Helper classes for waits, logging, and common actions.
• Configuration: Files and classes managing environment URLs, browser types, and credentials.

Configuration Patterns

Use testng.xml to define test suites and parameters like browser type.

Use pom.xml to manage dependencies and plugins.

Store environment URLs and credentials in src/test/resources/config.properties and load them in tests.

Example snippet to read browser parameter in TestNG:

@Parameters({"browser"})
@BeforeClass
public void setup(String browser) {
    if (browser.equalsIgnoreCase("chrome")) {
        // setup ChromeDriver
    } else if (browser.equalsIgnoreCase("firefox")) {
        // setup FirefoxDriver
    }
}
    

Test Reporting and CI/CD Integration

• Use TestNG default reports and extend with ExtentReports for detailed HTML reports.
• Integrate with CI tools like Jenkins to run tests on code commits.
• Configure Jenkins to run mvn test and archive reports.
• Use screenshots on test failures saved in target/screenshots/.

Best Practices for CSS Selector Usage in Selenium Java Framework

• Use unique IDs in CSS selectors when possible for fast and reliable element location (e.g., #submitBtn).
• Prefer simple selectors over complex chains to improve readability and maintainability.
• Use class selectors with caution; combine with element types to avoid ambiguity (e.g., button.primary).
• Avoid brittle selectors that depend on dynamic attributes or deep DOM hierarchy.
• Use CSS pseudo-classes like :nth-child() only when stable and necessary.

Self Check

Question: In this Selenium Java framework structure, where would you add a new CSS selector for a login button?

Answer: Add it in the appropriate Page Object class inside src/main/java/com/example/pages/.

Key Result

Organize Selenium Java tests with clear folder layers, use CSS selectors wisely in Page Objects, and configure tests via TestNG and Maven.

Practice

1. Which CSS selector syntax correctly selects an element with the id submitBtn?

easy

A. #submitBtn

B. .submitBtn

C. submitBtn

D. *submitBtn

Solution

1. Step 1: Understand CSS id selector syntax

   In CSS, the # symbol is used to select elements by their id attribute.

2. Step 2: Match the selector to the id

   The selector #submitBtn targets the element with id="submitBtn" exactly.

3. Final Answer:

   #submitBtn -> Option A

4. Quick Check:

   Id selector uses # = #submitBtn [OK]

Hint: Use # before id names to select by id [OK]

Common Mistakes:

• Using . instead of # for id
• Omitting # and using just the id name
• Using * which selects all elements

2. Which of the following is the correct CSS selector to select all elements with the class active?

easy

A. #active

B. *active

C. .active

D. active

Solution

1. Step 1: Recall CSS class selector syntax

   Classes are selected using a dot . followed by the class name.

2. Step 2: Identify the correct selector

   The selector .active selects all elements with class="active".

3. Final Answer:

   .active -> Option C

4. Quick Check:

   Class selector uses . = .active [OK]

Hint: Use . before class names to select by class [OK]

Common Mistakes:

• Using # instead of . for class
• Omitting . and using just class name
• Using * which selects all elements

3. Given the HTML snippet:

<input type="text" name="username" class="input-field" id="user" />

Which CSS selector will select this input element by its attribute name?

medium

A. input[name='username']

B. input#username

C. input.class='input-field'

D. input[name=username]

Solution

1. Step 1: Understand attribute selector syntax

   To select elements by attribute, use square brackets with attribute and value: [attr='value'].

2. Step 2: Match the selector to the input element

   input[name='username'] selects input elements with name="username" exactly.

3. Final Answer:

   input[name='username'] -> Option A

4. Quick Check:

   Attribute selector uses [attr='value'] = input[name='username'] [OK]

Hint: Use [attr='value'] to select by attribute [OK]

Common Mistakes:

• Missing quotes around attribute value
• Using # for attribute instead of []
• Incorrect syntax like input.class='input-field'

4. Identify the error in this CSS selector used in Selenium:
driver.findElement(By.cssSelector("div#main .content > p:first-child"));
What is wrong with this selector?

medium

A. The pseudo-class ':first-child' is not supported in CSS selectors.

B. The space between 'div#main' and '.content' is incorrect.

C. The '>' combinator cannot be used with classes.

D. The selector syntax is correct and will work as expected.

Solution

1. Step 1: Analyze the selector components

   The selector targets a p element that is the first child inside an element with class content, which is inside a div with id main.

2. Step 2: Check CSS selector validity in Selenium

   All parts including #main, .content, child combinator >, and pseudo-class :first-child are valid CSS selectors supported by Selenium.

3. Final Answer:

   The selector syntax is correct and will work as expected. -> Option D

4. Quick Check:

   Valid CSS selector syntax = correct [OK]

Hint: Check if selector uses valid CSS syntax supported by Selenium [OK]

Common Mistakes:

• Assuming pseudo-classes like :first-child are unsupported
• Misunderstanding combinator usage
• Thinking spaces between selectors are always wrong

5. You want to select all button elements that have both the class btn and an attribute data-action equal to save. Which CSS selector is correct?

hard

A. button#btn[data-action=save]

B. button.btn[data-action='save']

C. button .btn[data-action='save']

D. button.btn[data-action=save]

Solution

1. Step 1: Combine class and attribute selectors correctly

   To select elements with a class and attribute, chain selectors without spaces: button.btn[data-action='save'].

2. Step 2: Verify syntax details

   Quotes around attribute value are recommended for exact matching; no spaces between element, class, and attribute selectors.

3. Final Answer:

   button.btn[data-action='save'] -> Option B

4. Quick Check:

   Combine selectors without spaces = button.btn[data-action='save'] [OK]

Hint: Chain selectors without spaces; quote attribute values [OK]

Common Mistakes:

• Using spaces between element and class selectors
• Omitting quotes around attribute values
• Using # instead of . for class