This is an minimal example project to setup recheck-web:
- It contains a pom.xml file, that defines recheck-web as a needed test dependency.
- It contains an example std. Selenium test MySeleniumTest.java together with a login page to test.
- It contains the corresponding unbreakable recheck test.
- It contains the JUnit 5 extension file to integrate recheck into the JUnit life-cycle and omit calls to
capTest()(execute tests with param-Djunit.jupiter.extensions.autodetection.enabled=true). - It contains the Golden Master files (e.g. retest.xml) to which the rendered website is compared against.
- It contains the recheck config files:
- The recheck.ignore file defines which attributes (CSS and HTML) and elements (e.g. via XPath) should be ignored.
- The recheck.ignore.js file allows you to define rules in JavaScript, which differences should be ignored. You can find examples on this in the recheck-web project itself.
- The retest.properties file contains properties for your project that are relevant for retest, such whether you use rehub.
- A .travis.yml file, to have the build be executed on Travis.
- A slightly changed and a broken login page, so you can see differences by switching the used site in the the test.
In order to set it up correctly, you should install Java, Maven and Selenium on your local machine.
To apply changes to your golden masters, you need to install either the review GUI or the recheck CLI. Help to setup the CLI can be found in the docs.
You might also want to try out our Chrome Extension. You need to setup a free account with us to use it. You can e.g. compare the old budget with the new budget or the online version of the login page to the changed login page.
recheck-web can be used in conjunction with the Selenium IDE, to create tests quickly. As is shown in a some of the contained tests, you can even use recheck-web together with e.g. BrowserStack or Sauce Labs to do cross-browser testing or cross-device testing. Note that you need an account with each of them.
This project was mentioned in various articles, the latest of which is on opensource.com.
If you want to understand a bit more about the background, I suggest viewing a recent presentation or having a look at the slides.
If you have any questions, please contact us at retest.de.