#             .___      __     _____          __                         __  .__               
#    ______ __| _/_____/  |_  /  _  \  __ ___/  |_  ____   _____ _____ _/  |_|__| ____   ____  
#   /  ___// __ |/ __ \   __\/  /_\  \|  |  \   __\/  _ \ /     \\__  \\   __\  |/  _ \ /    \ 
#   \___ \/ /_/ \  ___/|  | /    |    \  |  /|  | (  <_> )  Y Y  \/ __ \|  | |  (  <_> )   |  \
#  /____  >____ |\___  >__| \____|__  /____/ |__|  \____/|__|_|  (____  /__| |__|\____/|___|  /
#       \/     \/    \/             \/                         \/     \/                    \/ 

seleniumJava

Selenium Startup Project for Java

Introduction

This project is made for anyone who is looking for a starting point for writing functional tests using Selenium WebDriver and Java.

This project was written using IntelliJ IDEA Community Edition.

Project Packages

• PageObjects: Contains class files for each web page being tested. Page element definitions / mappings, and functions for interacting with page elements.

• SeleniumExtensions: Contains helper function to instantiate WebDriver to the appropriate browser type. WebDriverExtensions class contains helper functions to handle driver waits for page elements conditions.

• TestHelper:

  • ConfigSettings: contains helper functions for reading config.properties.
  • IoLibrary: contains helper functions used across tests.
  • LoggingLibrary: contains custom functions for comparing actual to expected conditions.
  • TestAssert: Is a custom assert, used to track if a verification point has failed. The class variable is latched, once set to false it will remain false for the remainder of the test run.

Maven Java Project / Maven Wrapper

This project is written in Java and tests can be executed using Maven commands.

./mvnw clean install

Page Object Model

Page object model is used in this framework. Each web page will have its own java.class and within each class contains page element mappings and functions / methods used to interact /verify a specific web page under test.

Test web page

http://the-internet.herokuapp.com/      

Accessibility Testing

This project uses axe-selenium package for accessibility testing.

View accessibility test code: click here

View accessibility helper function: AccessibilityHelper.basicAccessibilityCheck()

Continuous Integration(CI)

A web hook has been setup with Travis CI for all Push and Pull Requests.

A web hook has also been setup with Github Actions, and Selenium Tests will execute with testcontainers during CI.

Selenium WebDriver

This project is configured to use Firefox & Chrome WebDriver's. The default is set to Chrome. The WebDriver's added to this project will only work on macos.

Testcontainers

Tests "SeleniumContainerTest" will execute Selenium test in a docker container. In order to execute this test using a testcontainer you must install docker, and also have docker running before test execution.

for more information: https://www.testcontainers.org/

Selenium Grid

Tests in this solution can also run on the Selenium Grid. Selenium Grid is hosted by www.gridlastic.com.

Questions / Contact / Contribute

Feel free to fork this repo, add to it, and create a pull request if you like to contribute.

If you have any questions, you can contact me via email: [email protected]