Submitting forms in Selenium Python - Framework Patterns

Framework Mode - Submitting forms

Folder Structure

tests/
├── test_login.py
├── test_registration.py

pages/
├── base_page.py
├── login_page.py
├── registration_page.py

utils/
├── driver_factory.py
├── config.py

reports/
├── test_report.html

conftest.py

pytest.ini

Test Framework Layers

• Driver Layer: Manages browser setup and teardown (e.g., driver_factory.py).
• Page Objects: Classes representing web pages with methods to interact with form elements and submit forms (e.g., login_page.py).
• Tests: Test scripts that use page objects to perform form submission and verify results (e.g., test_login.py).
• Utilities: Helper functions and configuration management (e.g., config.py).
• Configuration: Settings for environments, browsers, and credentials (managed in config.py and pytest.ini).

Configuration Patterns

• Environment Variables: Use environment variables or config.py to store URLs, credentials, and browser choices.
• Browser Selection: Parameterize browser choice in driver_factory.py to run tests on different browsers.
• Credentials Management: Store sensitive data securely outside code, load them at runtime.
• pytest.ini: Configure pytest options like markers and test paths.

Test Reporting and CI/CD Integration

• Test Reports: Use pytest plugins like pytest-html to generate readable HTML reports in reports/ folder.
• Logging: Add logging in tests and page objects to trace form submission steps.
• CI/CD: Integrate tests in pipelines (GitHub Actions, Jenkins) to run on code changes and publish reports.
• Failure Screenshots: Capture screenshots on test failure to help debugging.

Best Practices for Submitting Forms

• Use Page Object Model: Encapsulate form fields and submit actions in page classes for reuse and clarity.
• Explicit Waits: Wait for form elements to be visible and enabled before interacting to avoid flaky tests.
• Clear and Fill Inputs: Always clear input fields before typing to avoid leftover data issues.
• Validate Submission: Assert expected results after form submission, like success messages or page redirects.
• Parameterize Test Data: Use data-driven tests to submit forms with different inputs and verify behavior.

Self Check

Where would you add a new page object class for a "Contact Us" form in this framework structure?

Key Result

Organize Selenium Python tests with clear layers: driver setup, page objects for forms, test scripts, utilities, and config for clean, maintainable form submission automation.

Practice

1. What does the submit() method do in Selenium when testing forms?

easy

A. It sends the form data to the server by submitting the form.

B. It clears all input fields in the form.

C. It refreshes the current web page.

D. It closes the browser window.

Solution

1. Step 1: Understand the purpose of submit()

   The submit() method is used to send the form data to the server by submitting the form element.

2. Step 2: Compare with other options

   Clearing inputs, refreshing pages, or closing windows are not actions performed by submit().

3. Final Answer:

   It sends the form data to the server by submitting the form. -> Option A

4. Quick Check:

   submit() sends form data [OK]

Hint: Remember: submit() sends form data to server [OK]

Common Mistakes:

• Confusing submit() with clear() method
• Thinking submit() refreshes the page
• Assuming submit() closes the browser

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

easy

A. driver.submit(By.ID, 'form')

B. driver.submit_element(By.ID, 'form')

C. driver.find_element(By.ID, 'form').send_keys(Keys.ENTER)

D. driver.find_element(By.ID, 'form').submit()

Solution

1. Step 1: Identify correct Selenium syntax for submitting a form

   The correct method is to locate the form element and call submit() on it, like driver.find_element(By.ID, 'form').submit().

2. Step 2: Check other options for errors

   Options A and B use invalid method names. driver.find_element(By.ID, 'form').send_keys(Keys.ENTER) sends ENTER key but does not explicitly submit the form element.

3. Final Answer:

   driver.find_element(By.ID, 'form').submit() -> Option D

4. Quick Check:

   Use element.submit() to submit form [OK]

Hint: Use element.submit() after locating form [OK]

Common Mistakes:

• Using driver.submit() which does not exist
• Trying to submit with send_keys instead of submit()
• Calling submit on driver instead of element

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

form = driver.find_element(By.NAME, 'loginForm')
form.submit()

medium

A. The form with name 'loginForm' will be submitted to the server.

B. An error will occur because submit() is not a valid method.

C. Nothing happens because submit() does not trigger form submission.

D. The browser will close automatically.

Solution

1. Step 1: Locate the form element by name

   The code finds the form element with name 'loginForm' using find_element(By.NAME, 'loginForm').

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

   Calling submit() on the form element sends the form data to the server, triggering submission.

3. Final Answer:

   The form with name 'loginForm' will be submitted to the server. -> Option A

4. Quick Check:

   form.submit() submits form [OK]

Hint: submit() on form element sends data [OK]

Common Mistakes:

• Thinking submit() is invalid method
• Assuming submit() does nothing
• Confusing submit() with browser close

4. You wrote this code to submit a form:

form = driver.find_element(By.ID, 'signupForm')
form.submit

Why does the form not submit when you run it?

medium

A. Because the form ID is incorrect.

B. Because submit() method was not called with parentheses.

C. Because submit() is not supported on forms.

D. Because the driver is not initialized.

Solution

1. Step 1: Check method call syntax

   The code uses form.submit without parentheses, so the method is referenced but not executed.

2. Step 2: Understand effect of missing parentheses

   Without parentheses, the form does not submit because the method is not called. Adding () calls the method.

3. Final Answer:

   Because submit() method was not called with parentheses. -> Option B

4. Quick Check:

   Call submit() with () to execute [OK]

Hint: Always use parentheses to call methods [OK]

Common Mistakes:

• Forgetting parentheses after submit
• Assuming submit is a property, not a method
• Not verifying form locator correctness

5. You want to submit a form but only have access to an input field inside it. Which Selenium Python code correctly submits the form?

hard

A. form_element = driver.find_element(By.ID, 'form1')
form_element.submit()

B. input_element = driver.find_element(By.NAME, 'email')
driver.submit(input_element)

C. input_element = driver.find_element(By.NAME, 'email')
input_element.submit()

D. driver.find_element(By.NAME, 'email').send_keys(Keys.RETURN)

Solution

1. Step 1: Locate input inside the form

   You can find an input element inside the form using find_element(By.NAME, 'email').

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

   Calling submit() on any element inside the form submits the entire form.

3. Final Answer:

   input_element = driver.find_element(By.NAME, 'email') input_element.submit() -> Option C

4. Quick Check:

   submit() on input submits form [OK]

Hint: submit() on any form element submits the form [OK]

Common Mistakes:

• Trying to call driver.submit() which does not exist
• Using send_keys(Keys.RETURN) which may not submit form
• Not calling submit() on an element