Welcome to the FEST-Swing Module
FEST-Swing is a Java library that provides a fluent interface for functional Swing GUI testing. This library provides an easy-to-use API that makes creation and maintenance of GUI tests easy.
Why do we need to test GUIs?
Testing GUIs can make the entire system safer and more robust. Any GUI, even one providing only the simplest capabilities, likely encloses some level of complexity. Any complexity in software must be tested because code without tests is a potential source of bugs. A well-tested application has a greater chance of success.
GUI testing is also essential during application maintenance. During this phase, code might be refactored frequently to improve design, and this code often encloses great portions of the user interface. Having a solid test suite that includes GUI code can give us confidence that we are not inadvertently introducing bugs.
- Simulation of user interaction with a GUI (e.g. mouse and keyboard input, drag 'n drop)
- Reliable GUI component lookup (by type, by name or custom search criteria)
- Support for regular expression matching
- Support for all Swing components included in the JDK
- Compact and powerful API for creation and maintenance of functional GUI tests
- Supports Applet testing
- Ability to embed screenshots of failed GUI tests in HTML test reports
- Can be used with either TestNG or JUnit
- Supports testing violations of Swing's threading rules
- Experimental Groovy Builder support (coming soon!)
FEST-Swing requires Java SE 5.0 or later.
It can be downloaded here. For Maven 2 users, the project's repository can be found at http://fest.googlecode.com/svn/trunk/fest/m2/repository/ (groupId: fest, artifactId: fest-swing).
The following example shows a test verifying that an error message is displayed if the user forgets to enter her password when trying to log in an application:
How to install and begin using FEST-Swing.
Configuration, cell renderers and writers, etc.
Swing's Event Dispatch Thread (EDT)
Verifying violations in EDT access and how to prevent them.
Looking up GUI components to test.
Launching and testing applications and applets.
Input simulation using the mouse and keyboard, drag 'n drop actions, etc.
How to run GUI tests without disrupting your desktop, interrupting GUI tests, etc.
Running and troubleshooting FEST tests in Continuous Integration servers in different environments.
Troubleshooting GUI Test Failures
How to figure out what went wrong when GUI tests fail.
Component formatters, platform-specific behaviour, extending FEST-Swing, assertions with timeouts, etc.