This project is a collection of samples on how to use Vaadin TestBench. If you are looking for more information on TestBench, see https://vaadin.com/docs/v10/testbench/testbench-overview.html
This version is for Vaadin 10. For a version for Vaadin Framework 8, see https://github.com/vaadin/testbench-demo/tree/8.0 For a version for Vaadin Framework 7, see https://github.com/vaadin/testbench-demo/tree/7.7
The project is built using Maven. A similar setup can be done using other build systems as well. The Maven project can easily be imported into any IDE supporting Maven or used via the command line interface. Maven can be downloaded from: http://maven.apache.org.
The project produces a standard WAR file containing a simple calculator application written with Vaadin. During the build process TestBench tests are automatically run against the final war file using a Jetty server. The tests can be run from the command line by issuing the following command:
mvn verify
If you are running specific tests directly via an IDE, you might need to deploy the project beforehand to http://localhost:8080/. Any method will do, but the easiest one is probably Maven and the jetty-maven-plugin:
mvn jetty:run
The source code for the application to be tested, a desktop calculator
application, is given in the src/main/java subfolder.
The TestBench tests for the application are located under the
src/test/java subfolder.
The screenshot comparison example in src/test/java/com/vaadin/testbenchexample/advanced/ScreenshotIT.java grabs a screenshot and compares it to a reference file in src/test/screenshots. The first time it is run, it will automatically generate a reference screenshot in that folder, e.g. src/test/screenshots/oneplustwo_mac_chrome_64.png (exact file name depends on your operating system and browser). Normally the reference file generation would be handled by hand so you can verify that the screenshots look correct at the same time.