About
The Watir Exporter Plugin runs tests in the Graphical Test Editor using Ruby and Watir. It also exports tests to external Ruby/Watir code.
Watir provides a fast and robust way to run the tests.
Before the runner will work, Ruby and Watir must be installed. See http://wtr.rubyforge.org/install.html for installation instructions.
The plugin is written and maintained by the CubicTest team.
Default timeout is 5 seconds when asserting page elements. To change, set a different timeout in test-project.properties or on an initial Transition / User Interaction.
Features
- Supports the entire CubicTest test model (all identifiers, actions and contexts), though with a small limitation on Options i Select lists.
- Gives you direct feedback by coloring the test model.
System requirements
- This plugin requires that the following is installed (see http://wtr.rubyforge.org/install.html)
- Ruby
- Watir (version 1.5 or above)
How to use
Running the tests directly in the GUI
- Create/open a tests
- Right click in test editor -> choose "Run Test with Watir"
This opens Internet Explorer and runs the tests. The results are shown in the test model. Green = pass, red = fail, orange = exception - Click "Reset test-run" to remove the coloring of the test.
Exporting to Watir files without running them
Alternatively, the tests can be exported to separate Ruby/Watir files for running in an existing runner/build environment:
- Create the tests as normally.
- Right click in test editor (or on the file in the package explorer) -> choose "Export to Watir tests script"
The generated files are placed in the "generated" subfolder of the test project (found in the package explorer).
Limitations
- There is currently no support for Custom Test Steps.
- Options cannot have more than one identifier
- If contexts or multiple identifiers are in use, the HTML page must be syntactically valid and will be parsed by Watir and REXML. This will take a bit longer than when only one identifier is used.