Selenium Test Framework

Overview

This repository contains a Selenium WebDriver Java-based Automation Framework designed to facilitate the testing of web applications. The framework is adaptable to meet the requirements of any automation project.

Features

• Selenium WebDriver for automated browser interaction.
• TestNG for managing test execution, grouping, and reporting.
• Page Object Model (POM) design pattern for maintaining reusable and clean test code.
• Data-Driven Testing using Excel file for passing test data.
• Parallel Execution with TestNG to run tests across multiple browsers and configurations.
• Screenshots capture during test execution for failure analysis.
• Logging using Log4j for enhanced test result reporting.
• Extent Report for customized reporting.
• AES encryption for encryption and decryption of sensitive data.

Prerequisites

Before running the framework, make sure to have the following installed:

• Java 11 or higher
• Maven (for dependency management)
• IDE (IntelliJ Idea or Eclipse)

Getting Started

1. Clone the Repository

To get started with the framework, first clone the repository:

git clone https://github.com/JagatheshwaranN/Selenium-Test-Framework.git

2. Set Up the Project

The project is managed by Maven. To download all necessary dependencies, navigate to the project directory and run:

mvn clean install

3. Run Tests

Alternatively, you can run specific TestNG XML suites for targeted test execution:

 mvn test -DsuiteXmlFile='testng.xml' -'Dorg.freemarker.loggerLibrary=NONE'

4. Generating Reports

• Extent will generate an HTML report in the /resources/report directory after test execution.
• TestNG will automatically generate an HTML report in the /test-output directory after test execution.
• Additionally, screenshots will be captured for any failed test and stored in the /resources/screenshots folder.

Directory Structure

SeleniumTestFramework/
└── src/
    ├── main/
    │   ├── java/
    │   │   └── com/
    │   │       └── qa/
    │   │           └── stf/
    │   │               ├── base/
    │   │               │   ├── BasePage
    │   │               │   ├── BrowserManager
    │   │               │   ├── DriverManager
    │   │               │   ├── ElementActions
    │   │               │   └── EnvironmentManager
    │   │               ├── constant/
    │   │               │   ├── BrowserType
    │   │               │   ├── EnvType
    │   │               │   └── TestConstants
    │   │               ├── handler/
    │   │               │   ├── AlertHandler
    │   │               │   ├── BrowserHandler
    │   │               │   ├── DateTimeHandler
    │   │               │   ├── DropDownHandler
    │   │               │   ├── JavaScriptHandler
    │   │               │   ├── VerificationHandler
    │   │               │   └── WaitHandler
    │   │               ├── listener/
    │   │               │   └── TestListener
    │   │               ├── report/
    │   │               │   └── ExtentReportManager
    │   │               └── util/
    │   │                   ├── DataSupplier
    │   │                   ├── EncryptionManager
    │   │                   ├── ExcelReader
    │   │                   ├── ExceptionHub
    │   │                   ├── ExtentUtil
    │   │                   └── FileReader
    │   └── resources/
    │       ├── config/
    │       │   └── configuration.properties
    │       └── log4j2.properties
    ├── test/
    │   ├── java/
    │   │   └── com/
    │   │       └── qa/
    │   │           └── stf/
    │   │               └── app/
    │   │                   ├── base/
    │   │                   │   └── BaseTest
    │   │                   ├── constant/
    │   │                   │   └── AppConstants
    │   │                   ├── elements/
    │   │                   │   ├── AdminPageElement
    │   │                   │   ├── DashboardPageElement
    │   │                   │   ├── LoginPageElement
    │   │                   │   └── TimesheetPageElement
    │   │                   ├── objects/
    │   │                   │   ├── AdminPageObject
    │   │                   │   ├── DashboardPageObject
    │   │                   │   ├── LoginPageObject
    │   │                   │   └── TimesheetPageObject
    │   │                   ├── pages/
    │   │                   │   ├── AdminPage
    │   │                   │   ├── DashboardPage
    │   │                   │   ├── PageManager
    │   │                   │   └── TimesheetPage
    │   │                   └── testcases/
    │   │                       ├── AdminPageTest
    │   │                       ├── LoginPageTest
    │   │                       └── TimesheetPageTest
    │   └── resources/
    │       ├── data/
    │       │   └── testData.xlsx
    │       ├── logs/
    │       │   └── AutomationExecution.log
    │       ├── report/
    │       │   └── ExtentReport.html
    │       ├── runner/
    │       │   └── testng.xml
    │       └── screenshots/
    │           └── 19_01_2025_11_21_07.png
    └── pom.xml