Skip to content

README.md

Latest commit

 

History

History
81 lines (60 loc) · 3.24 KB

README.md

File metadata and controls

81 lines (60 loc) · 3.24 KB
Raw

Selenium Java Automation Framework

License: MIT Java Selenium TestNG Allure

A robust, enterprise-ready end-to-end test automation framework built with Java 21, Selenium WebDriver, TestNG, and Maven, targeting modern web applications with comprehensive reporting via Allure and structured JSON test telemetry.

Key Features

  • Page Object Model (POM): Clean separation of test logic and page interaction layers.
  • Dynamic Element Synchronization: Explicit WebDriverWait and ExpectedConditions handling dynamic web elements, timeouts, and state transitions.
  • Telemetry & Reporting:
    • Automated HTML reports via Allure Report.
    • Structured JSON export (target/test-results.json) through custom TestResultListener, enabling downstream analytics in dashboards like TestNexus.
  • Cross-Browser Architecture: Configurable browser execution across Chrome, Edge, and Firefox.
  • CI/CD Ready: Automated execution via Maven Surefire plugin.

Test Suites & Coverage

  • Elements Suite:
    • Text Box (TextBoxTest): Data entry, form submission, and output validation.
    • Check Box (CheckBoxTest): Tree-node selection and multi-branch checks.
    • Radio Button (RadioButtonTest): Option selection and state assertions.
    • Web Tables (WebTablesTest): Record addition, editing, row deletion, and table search.
    • Buttons (ButtonTest): Double-click, right-click, and dynamic single-click validations.
    • Links (LinkTest): Navigation redirects, HTTP status validation (200, 301, 400, 404, 500).
    • Broken Links & Images (BrokenLinkImageTest): HTTP status verification and broken image DOM detection.
    • Upload & Download (UploadAndDownloadTest): File download verification and multipart file uploads.
    • Dynamic Properties (DynamicPropertiesTest):
      • TC014: Verification of button enablement after 5-second asynchronous delay.
      • TC015: Text color transition validation after 5 seconds.
      • TC016: Element visibility wait assertion after 5-second delay.

Getting Started

Prerequisites

  • JDK 21+
  • Apache Maven 3.9+
  • Google Chrome (or target browser)

Installation & Execution

  1. Clone the repository:

    git clone https://github.com/chiragbitoni/SeleniumJavaAutomationFramework.git
cd SeleniumJavaAutomationFramework

  2. Compile and build:

    mvn clean test-compile

  3. Run the full regression test suite:

    mvn test

  4. Generate and view Allure Report:

    allure serve allure-results

  5. JSON Test Results: Execution results are automatically recorded in target/test-results.json after test completion.

License

This project is licensed under the MIT License.