A more detailed video deep-dive can be viewed by skipping to 33:30 of this video: Karate Version 1.3.0 Release Webinar
The included features are numbered 1 through 7 and build on each other. They are intended to demonstrate how you might start from scratch without any baseline images on a new project:
1_establish_baseline.featureestablishes baseline images to use in future test runs
2_compare_baseline.featurecompares dynamic screenshots against our baseline images
3_custom_rebase.featuredemonstrates the use of the
onShowRebasehandler to customize the filename when rebasing
4_generic_rebase.featureshows a slightly more advanced use of the
onShowRebasehandler that incorporates image comparison configuration options
5_custom_config.featureshows a complete scenario that is similar to what you might use in real tests
6_outline.featureexplores a more complex use case with multiple browsers
7_api.featuresolves some issues identified in the outline feature above using the JS API
There is also a screencast that demonstrates basic usage of the diff UI in the Karate HTML report.
5_custom_config.feature is a complete Karate UI test that can be executed by running
ImageComparisonRunner as a JUnit test. You will be able to open the HTML report (the file-name will appear at the end of the console log) and refresh it when re-running the test.
To manually run the test execute the following commands:
- Install maven artifacts from the latest develop branch locally
mvn clean install -P pre-release
- Run the test from the
mvn clean test -Dtest=ImageComparisonRunner
You should be able to use the Karate extension for Visual Studio Code for stepping-through a test for troubleshooting.