Submitting forms in Selenium Java - Framework Patterns

Framework Mode - Submitting forms

Folder Structure

src/
└── test/
    └── java/
        └── com/
            └── example/
                ├── pages/
                │   └── LoginPage.java
                ├── tests/
                │   └── LoginTest.java
                ├── utils/
                │   └── WebDriverFactory.java
                └── config/
                    └── ConfigReader.java

Test Framework Layers

• Driver Layer: Manages browser setup and teardown (e.g., WebDriverFactory.java).
• Page Objects: Classes representing web pages with methods to interact with form elements and submit forms (e.g., LoginPage.java).
• Tests: Test classes that use page objects to perform form submission tests (e.g., LoginTest.java).
• Utilities: Helper classes for common tasks like reading configs or waiting for elements.
• Configuration: Handles environment variables, browser types, and credentials (e.g., ConfigReader.java).

Configuration Patterns

• Use config.properties file to store environment URLs, browser types, and user credentials.
• Load configuration in ConfigReader.java to provide easy access to test settings.
• Allow switching browsers via command line or environment variables for flexibility.
• Keep sensitive data like passwords outside source code, use environment variables or encrypted files.

Test Reporting and CI/CD Integration

• Use TestNG built-in reports for pass/fail status and test details.
• Integrate with tools like Allure or ExtentReports for detailed HTML reports showing form submission results.
• Configure CI/CD pipelines (e.g., Jenkins, GitHub Actions) to run tests automatically on code changes.
• Fail builds if form submission tests fail to catch issues early.

Best Practices

• Use Page Object Model: Encapsulate form fields and submit actions in page classes for easy maintenance.
• Explicit Waits: Wait for form elements to be visible and enabled before interacting to avoid flaky tests.
• Data-Driven Testing: Use external data sources (CSV, Excel) to test form submissions with multiple input sets.
• Clear Naming: Name methods clearly like fillUsername(), submitForm() for readability.
• Keep Tests Independent: Each test should set up its own form state and not rely on others.

Self Check

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

Key Result

Organize Selenium Java tests with Page Objects for forms, config for environments, and clear test layers.

Practice

1. In Selenium Java, which method is used to submit a form on a web page?

easy

A. submit()

B. click()

C. sendKeys()

D. getText()

Solution

1. Step 1: Understand form submission in Selenium

   The submit() method is designed specifically to submit forms in Selenium.

2. Step 2: Differentiate from other methods

   Methods like click() simulate clicking but do not necessarily submit forms; sendKeys() inputs text; getText() retrieves text.

3. Final Answer:

   submit() -> Option A

4. Quick Check:

   Form submission method = submit() [OK]

Hint: Use submit() to send form data, not click() [OK]

Common Mistakes:

• Using click() instead of submit() to send form
• Confusing sendKeys() with form submission
• Trying to submit without locating form element

2. Which of the following is the correct way to submit a form using Selenium WebDriver in Java?

easy

A. driver.findElement(By.id("formId")).submit();

B. driver.submit(By.id("formId"));

C. driver.findElement(By.id("formId")).click();

D. driver.findElement(By.id("formId")).sendKeys("submit");

Solution

1. Step 1: Locate the form element correctly

   Use findElement(By.id("formId")) to get the form element by its ID.

2. Step 2: Call submit() on the form element

   Calling submit() on the form element sends the form data.

3. Final Answer:

   driver.findElement(By.id("formId")).submit(); -> Option A

4. Quick Check:

   Correct syntax = driver.findElement(...).submit() [OK]

Hint: Call submit() on the form element, not on driver [OK]

Common Mistakes:

• Trying to call submit() directly on driver
• Using click() instead of submit() on form
• Sending keys 'submit' instead of calling submit()

3. What will happen when the following Selenium Java code runs?

WebElement input = driver.findElement(By.name("username"));
input.sendKeys("user1");
input.submit();

medium

A. Only the input field is cleared but form is not submitted.

B. An exception is thrown because submit() cannot be called on input elements.

C. The form containing the input field is submitted with 'user1' as username.

D. The page reloads without submitting any data.

Solution

1. Step 1: Identify element and actions

   The code finds an input field named "username", enters "user1" text, then calls submit() on that input element.

2. Step 2: Understand submit() behavior on child elements

   Calling submit() on any child element inside a form submits the entire form containing that element.

3. Final Answer:

   The form containing the input field is submitted with 'user1' as username. -> Option C

4. Quick Check:

   submit() on input submits parent form [OK]

Hint: submit() on input submits its parent form [OK]

Common Mistakes:

• Thinking submit() only works on form elements
• Expecting submit() to clear input instead of submitting
• Assuming submit() throws exception on input elements

4. Consider this Selenium Java code snippet:

WebElement form = driver.findElement(By.id("loginForm"));
form.click();
form.submit();

What is the main issue with this code?

medium

A. submit() must be called before click() on the form.

B. submit() cannot be called on a form element.

C. The form element is not located correctly.

D. Calling click() on the form element may cause unexpected behavior before submit.

Solution

1. Step 1: Analyze click() on form element

   Calling click() on a form element is unusual and may trigger unexpected UI behavior or errors.

2. Step 2: Confirm submit() usage

   Calling submit() on the form element is correct and will submit the form.

3. Final Answer:

   Calling click() on the form element may cause unexpected behavior before submit. -> Option D

4. Quick Check:

   click() on form is risky; submit() is correct [OK]

Hint: Avoid click() on form; use submit() directly [OK]

Common Mistakes:

• Thinking submit() cannot be called on form
• Assuming click() is needed before submit()
• Ignoring potential side effects of clicking form

5. You want to submit a form that has no id or name attribute but contains a submit button with class "submit-btn". Which Selenium Java code correctly submits the form?

hard

A. driver.findElement(By.className("submit-btn")).submit();

B. driver.findElement(By.className("submit-btn")).click();

C. driver.findElement(By.tagName("form")).submit();

D. driver.findElement(By.tagName("button")).submit();

Solution

1. Step 1: Locate the submit button by class

   Since the form lacks id or name, find the submit button using its class "submit-btn".

2. Step 2: Call click() on the submit button element

   Calling click() on the submit button simulates pressing the button, which submits the form.

3. Final Answer:

   driver.findElement(By.className("submit-btn")).click(); -> Option B

4. Quick Check:

   click() on submit button triggers form submission [OK]

Hint: Submit form by clicking the submit button [OK]

Common Mistakes:

• Using submit() instead of click() on submit button
• Trying to submit form by tagName without verifying uniqueness
• Calling submit() on button tag which may not be inside form