JarCastingGherkinSalad
This framework makes it easy to
- Create page objects and use them
- Create complex reusable component objects
- Get a jumpstart on UI automation
gS uses Java, Maven, WebDriver
Features
- DSL to interact with page objects, perform validations and create reusable complex component objects
- Several pre built and tested component objects
- Wrapper on top of WebElement that provides several methods that help speed up automation
- Reporting module that can work with Cucumber or without it to create detailed reports
- Built in support to write page objects and automation suites that do not fail strictly
Basic Usage
Create a page object
public class TwitterHomePage extends Component {
public TwitterPage() {
super.found(By.tagName("body"));
}
}
public class TwitterLoginPage extends Component {
public TwitterLoginPage() {
super.found(By.tagName("body"));
}
}
This defines the page object that represents the content within the body tag - basically the entire page.
Creating the step definition
public class TwitterSteps extends Component {
TwitterLoginPage login_page = new TwitterLoginPage();
TwitterHomePage home_page = new TwitterHomePage();
@Given("^User A is logged in$")
public void login() {
super.launch_browser("firefox");
login_page.login_as("username", "password");
}
@After
public void teardown() {
close_browser();
}
}
The page object is created by simply using the constructor. Within the page object all the interactions will happen with the instance of browser that is currently available. The framework under the Component object handles it.
Within the page object
Working with HTML links and buttons
Clickable somelink = Link.find(By.id("someid"));
somelink.click_if_enabled();
The first line of code will create an object that has methods to perform click for the element that can be identified by the locator specified. The second line performs the clicking of the link only if it is enabled. For more information about Clickable check the javadocs
Working with Drop Downs
Selectable someDropDown = DropDown.find(By.id("someid"));
someDropDown.select_option_if_enabled("some text");
This will select the first option in the dropdown that has the text specified. For more information about Selectable check the javadocs
Working with Text Box and Text Area
TextEnterable someTextField = TextField.find(By.id("someid"));
someTextField.enter_text_if_enabled("text to enter");
This will find a text field, clear the existing text and enter new text in there.
TextEnterable someTextField = TextArea.find(By.id("someid"));
someTextField.enter_text_if_enabled("text to enter");
This will find a text area, clear the existing text and enter new text in there.
More Information
More information can be found on the wiki
Support
Open an issue here
OR
Contact me at gherkinsalad [ a t ] gmail
Copyright
Copyright (c) 2011 - 2012 Ayan Dave http://daveayan.com
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
- The above copyright notice and this permission notice shall be included without any changes or alterations in all copies or substantial portions of the Software.
- This software shall be used for Good, not Evil.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.