The Tapestry Test Utilities is a small library to make it easier to build integration test suites around Selenium version 2.14.0.
The strategy is to start, in process, a Selenimum Server (which, in turn, starts and manages a web browser), a Jetty instance (for the web browser to talk to), and a Selenium client (which talks to the server).
The client is able to request URLs, fill in form data, click links, and make assertions about output and behavior.
The core part of this library is a base class for you to extend your tests classes : SeleniumTestCase.
This class is responsible for starting an instance of Jetty to server your web application, as well as a copy of Selenium Server. It also implements the Selenium interface.
|Before Tapestry 5.2, your class should extend AbstractIntegrationTestSuite|
Here's an example from one of the Tapestry modules:
With the SeleniumTestCase class, you can use basic Selenium methods (such as open() and type()) and methods added by the SeleniumTestCase base class (clickAndWait() and assertFieldValue()).
In addition, the SeleniumTestCase base class extends the normal exception reporting provided by Selenium; when a failure occurs inside Selenium server, a more detailed message, including the current page's HTML source, is reported to System.err.
All the configuration of your Integration Tests should be in your testng.xml file. Tapestry provides some parameters, in order to have the right environment for your tests.
|tapestry.web-app-folder||src/main/webapp||The path to a web app|
|tapestry.servlet-container||jetty7||the server container to use for the integration tests (jetty7 or tomcat6)|
|tapestry.context-path||The context path|
|tapestry.port||9090||The web server port|
|tapestry.ssl-port||8443||The web server ssl port|
|tapestry.browser-start-command||*firefox||The browser command to pass to Selenium|
Here's an example :
Here are some interesting plugins you can use to write your integration tests.