You went through lots of concepts and would like to see how they all work together.
Where can you find a project that uses everything you learned and more?
Here :)
What follows is a small project that I built a while ago for a job interview.
It uses many test automation concepts such as:
- page factory
- base classes
- html classes
- test listeners
- test ng assertions and fixtures
- annotations
- custom locators (javascript and jquery)
- screenshots
- saving errors in text files
The exercise consisted in automating the following test case with Java and Selenium WebDriver:
- Launch bestbuy url (www.bestbuy.ca)
- Search a product and add it to cart
- Go all the way through checkout process and place the order with invalid credit card
- Capture the error message due to invalid credit card
Before downloading the project and checking the source code, a few details about the project.
Project details
- Maven project
- - all dependencies are managed through the pom.xml file
- Test NG
- - unit testing library
- Java JDK 8
- - used for lambda expressions and streams
- Page Factory
- - pattern for creating page object and page fragment classes
- - the elements of page object/fragment classes have names and locators
- - names and locators are implemented using annotations
- - available locator types are id, xpath, css, name and javascript
@Name("SEARCH_HEADER") @FindBy(className = "main-navigation-container") public class SearchHeader extends HtmlElement{ @Name("SEARCH_FIELD") @FindBy(id = "ctl00_MasterHeader_ctl00_uchead_GlobalSearchUC_TxtSearchKeyword") private TextInput searchKeywordTxt; @Name("SEARCH_BUTTON") @FindBy(id = "ctl00_MasterHeader_ctl00_uchead_GlobalSearchUC_BtnSubmitSearch") private Button searchBtn; public void search(String keyword) { searchKeywordTxt.click(); searchKeywordTxt.clear(); searchKeywordTxt.sendKeys(keyword); searchBtn.click(); } }
The project has the automation framework classes in the main folder and all test items in the test folder.
Main folder (framework classes)
- annotations classes
- - FindBy
- - FindByJQUERY
- - FindByJS
- - Name
- - Timeout
- html element classes
- exceptions classes
- decorator and proxy classes used by the page factory
- page class
- - used as base class for the page object classes
- page factory classes
- miscellaneous classes such as
- - custom driver class, screenshot class
- - enumerations (used to avoid hardcoding data in the page objects)
- - simple logger class
- - property class
- - TextFile class
package com.bestbuy.demo.annotations; import java.lang.annotation.ElementType; import java.lang.annotation.Retention; import java.lang.annotation.RetentionPolicy; import java.lang.annotation.Target; @Retention(RetentionPolicy.RUNTIME) @Target({ElementType.TYPE, ElementType.FIELD}) public @interface Name { String value(); }
package com.bestbuy.demo.element; import org.openqa.selenium.By; import org.openqa.selenium.NoSuchElementException; import org.openqa.selenium.WebElement; public class CheckBox extends TypifiedElement { public CheckBox(WebElement wrappedElement) { super(wrappedElement); } public WebElement getLabel() { try { return getWrappedElement().findElement(By.xpath("following-sibling::label")); } catch (NoSuchElementException e) { return null; } } public String getLabelText() { WebElement label = getLabel(); return label == null ? null : label.getText(); } public String getText() { return getLabelText(); } public void select() { if (!isSelected()) getWrappedElement().click(); } public void deselect() { if (isSelected()) getWrappedElement().click(); } public void set(boolean value) { if (value) select(); else deselect(); } }
Test folder (test items)
- base test class (used as base by the test classes)
- page objects classes (all page object and page fragment classes)
- test listeners (class for taking a screenshot and logging exceptions in case of failures)
package com.bestbuy.demotests.testlisteners; import java.lang.reflect.Field; import org.testng.ITestContext; import org.testng.ITestListener; import org.testng.ITestResult; import com.bestbuy.demo.exceptions.HtmlElementsException; import com.bestbuy.demo.utils.Driver.BrowserDriver; import com.bestbuy.demo.utils.Driver.Screenshot; import org.openqa.selenium.WebDriver; import static com.bestbuy.demotests.BaseTest.BaseTestClass.*; public class TestListener implements ITestListener { @Override public void onTestFailure(ITestResult result) { try { Screenshot screenshot = new Screenshot(getDriverFromBaseTest(result)); screenshot.capture(result.getName()); } catch (Exception ex) { throw new HtmlElementsException(ex.getMessage()); } } @SuppressWarnings("unchecked") private WebDriver getDriverFromBaseTest(ITestResult result) throws IllegalAccessException { WebDriver driver = null; try { Class< ? extends ITestResult> testClass = (Class< ? extends ITestResult>) result.getInstance().getClass(); Class< ?extends ITestResult> baseTestClass = (Class< ? extends ITestResult>) testClass.getSuperclass(); Field driverField = baseTestClass.getDeclaredField("driver"); driver = (BrowserDriver)driverField.get(result.getInstance()); return driver; } catch (SecurityException | NoSuchFieldException | IllegalArgumentException ex) { throw new HtmlElementsException("error getting the driver from base test"); } } @Override public void onTestSuccess(ITestResult result) {} @Override public void onTestSkipped(ITestResult result) {} @Override public void onTestFailedButWithinSuccessPercentage(ITestResult result) {} @Override public void onStart(ITestContext context) {} @Override public void onFinish(ITestContext context) {} @Override public void onTestStart(ITestResult arg0) {} }
Most interactions with web elements are done through the page factory classes.
Occasionally, Javascript code is used when buttons cannot be clicked through the page factory.
Some of the pages have random popups that are closed if displayed.
The test script does the following:
- Open the home page
- Execute a keyword search
- Select the Online Only filter
- Select a product with online availability
- Add the product to the cart
- Continue checkout on the basket page
- Select New Member
- Fill in the Ship To info
- Select credit card as payment method
- Fill in the payment info
- Submits transaction
- Verify that there is at least an error message
- Saves the error messages and the search keyword to a text file
The test script uses a keyword parameter which can take multiple values.
Download source code
ReplyDeleteThis blog explains the details of most popular technological details. This helps to learn about what are all the different method is there. And the working methods all of that are explained here. Informative blog.
SEO Company in Chennai
Great post! I am actually getting ready to across this information, It's very helpful for this blog.Also great with all of the valuable information you have Keep up the good work you are doing well.
ReplyDeleteIELTS Coaching Classes in Chennai
Awesome post, I think this is an important information that everyone should know from automation point of view.
ReplyDeleteThanks a lot.
Selenium training in Chennai | Best Selenium training institute in Chennai
Superb explanation & it's too clear to understand the concept as well, keep sharing admin with some updated information with right examples.Keep update more posts.
ReplyDeleteInformatica Training in Chennai
Dataware Housing Training in Chennai
Link for the source code gives a 404. Could you please repost it?
ReplyDeleteLink for the source code gives a 404. Could you please repost it?
ReplyDeletethe link has been fixed.
Deletehi thank you so much for sharing . it’s useful for me.
ReplyDeleteSelenium Training in Chennai
Dot Net Training in Chennai
Dot Net Training in Chennai
Thanks Alex for Page factory sample project.
ReplyDeleteCan you also share posts and sample project for Cucumber JVM. Now a days many customers are demanding for BDD.
Right,Good to see these helpful information here Jobs in Testing .Thanks lots for sharing them with us.
ReplyDelete