hmpps-test-automation-framework

selenium-cucumber-ui-tests

Selenium-Cucumber is a behavior driven development (BDD) approach to write automation test script to test Web. It enables you to write and execute automated acceptance/unit tests. It is cross-platform, open source and free. Automate test cases with minimal coding.

ui-tests

UI test suite for the hmpps services using Webdriver and java/cucumber

Running the tests

Prior to executing the tests ensure you have:

• Docker - to run a Chrome or Firefox browser inside a container
• Appropriate drivers installed - to run tests against locally installed Browser

Then execute the run_tests_local.sh script:

The run_tests_local.sh script allows to choose an environment with the locally installed chrome driver binary. For a complete list of supported param values, see:

• src/test/java/utils/Configuration.java for environment

Running tests against a containerised browser - on your machine

The script ./run-tests-with-docker.sh can be used to start a Chrome or Firefox container on your machine.

To run against a containerised Chrome browser:

./run-tests-with-docker.sh executes tests using remote-chrome 
./run-tests-local.sh requires to pass parameters

./run-tests-with-docker.sh is NOT required when running in a CI environment.

• supports macos
• Browser versions available here Geckodriver or Chromedriver repositories.

Note 1: Need to ensure that you have a recent version of Chrome and/or Firefox installed for the later versions of the drivers to work reliably.