Роман Иовлев «Open Source UI Automation Tests on C#»

OPEN SOURCE UI
AUTOMATION ON C#
2 MARCH 2017

Chief QA Automation
In Testing more than 11 years
In Testing Automation 9 years
ROMAN IOVLEV

4
JDI SETUP
README
http://jdi.epam.com/
https://github.com/epam/JDI
https://vk.com/jdi_framework

SIMPLE TEST
ProductPage.ProductType.Select(«jacket»);
ProductPage.Price.select(«500$»);
ProductPage.Colors.check(«black», «white»);
Assert.isTrue(ProductPage.Label.getText(),
«Armani Jacket»)
6

SIMPLE TEST
LoginPage.Open();
LoginPage.LoginForm.Login(admin);
SearchPage.Search.Find(«Cup»);
Assert.AreEqual(ResultsPage.Products.Count(), expected);
7

PAGE OBJECTS
Tests Page Objects
Driver
(Engine)
Application
ELEMENTS
private IWebElement UserName;
private IWebElement Password;
private IWebElement LoginButton;
• ACTIONS
• EnterUserName(String name);
• EnterPassword(String name);
• ClickLoginButton();
• BUSINESS ACTIONS
• Login(User user)
9

PAGE ELEMENTS
ELEMENTS
public TextField UserName;
public TextField Password;
public Button LoginButton;
• ACTIONS
• ---
• BUSINESS ACTIONS
• Login(User user)
ELEMENT
public DropDown UserStatus;
• ACTIONS
• Select(string option)
• boolean IsSelcted()
• List<String> AllOptions()
• string GetValue()
10

ELEMENTS
 Simple
 Complex
 Composite
11

SIMPLE ELEMENTS
[FindBy (Css=“.description”)]
public Text Description;
public Button Submit;
public Label ProductName;
public Link FollowMe;
public TextArea Abuse;
public CheckBox RememberMe;
public DatePicker Date;
public FileInput Upload;
public Image Photo;
13
NEWS

SIMPLE ELEMENTS
[FindBy(Css=“.btn”) ]
public Button submit;
14
[FindBy(Xpath=“//button”) ]
[FindBy(Id=“button-id”) ]
[FindBy(Name=“button”) ]
public Button submit =
new Button(By.Css(“.btn”));
public IButton submit;

MULTILOCATORS
15
Multi language testing
[JFindBy (text=“Submit”, group=“en”) ]
[JFindBy (text=“Отправить” , group=“ru”) ]
Multi version testing
[JFindBy(text=“Submit”, group=“1.7”) ]
[JFindBy(value=“Submit” , group=“2.0”) ]

PLATO'S THEORY OF FORMS
5
No application but you can write UI Objects (Page Objects )
IButton

COMPLEX ELEMENTS
public Dropdown Colors;
public Checklist Settings;
public ComboBox Tags;
public DropList ShirtSizes;
public List<Element> SearchResults;
public Elements Reviews;
public Table Products;
public Menu MainMenu;
public Tabs Areas;
public Selector Vote;
public RadioButtons Rating;
public TextList Chat; 18

COMPLEX ELEMENTS
[FindBy (Css = “.colors") ]
public Dropdown colors = new Dropdown {
Value = By.Css(".value"),
List = By.TagName(“li")
};
19
[FindBy (Css = “.offers") ]
public Table offers = new Table {
Row = By.Css(".value"),
Column = By.TagName(“li"),
Header = new [] {“ID", “Title", “Apply”}
};

COMPLEX ELEMENTS
[FindBy (Css = “.colors") ]
public Dropdown Colors;
[FindBy (Css = “.table”) ]
public Table Offers;
20
[FindBy (Css = “.menu li”) ]
public Menu Navigation;
[FindBy (Css = “.menu ul”) ]
[FindBy (Xpath = “//*[@class=‘menu’]//li[text()=‘%s’]”) ]

• Code readability
• Clear behavior
• Union of all element’s locators
• Union of element and its actions
• Detailed logging
TYPIFIED ELEMENTS
21

Text Description;
Button Submit;
Label ProductName;
Link FollowMe;
TextField Password;
TextArea Abuse;
CheckBox RememberMe;
DatePicker Date;
FileInput Upload;
Image Photo;
IWebElement Description;
IWebElement SubmitButton;
IWebElement ProductName;
IWebElement FollowMeLink;
IWebElement PasswordField;
IWebElement Abuse;
IWebElement RememberMe;
IWebElement DatePicker;
IWebElement Upload;
IWebElement Photo;
COMPARE
22

COMPARE
[FindBy(css = “.colors") ]
public Dropdown colors = new Dropdown {
Value = By.Css(".value"),
List = By.TagName(“li") };
[FindBy(Css = “.colors .value") ]
IWebElement ColorsValue;
[FindBy (Css = “.colors li") ]
List<IWebElement> ColorsList;
public string GetColor() {
return ColorsValue.GetText();
}
public void SelectColor(String ColorName) {
ColorsValue.Click();
for (IWebElement Color : ColorsList)
if (Color.getText().Equals(ColorName) {
Color.Click();
return;
} 23

COMPARE
[FindBy (Id = “trades") ]
public Table Colors;
[FindBy (Id = “…") ]
private List<IWebElement> ResultsColHeaders;
private List<IWebElement> ResultsRowsHeaders;
private List<IWebElement> ResultsCellsHeaders;
private List<IWebElement> ResultsColumn;
private List<IWebElement> ResultsRow;
ICell cell(Column column, Row row) { }
ICell cell(String columnName, String
rowName) { }
ICell cell(int columnIndex, int rowIndex) { }
List<ICell> cells(String value) { }
List<ICell> cellsMatch(String regex) { }
ICell cell(String value) { }
ICell cellMatch(String regex) { }
MapArray<String, MapArray<String, ICell>>
rows(String... colNameValues) { }
MapArray<String, MapArray<String, ICell>>
columns(String... rowNameValues) { }
boolean waitValue(String value, Row row) { }
boolean waitValue(String value, Column
column) { }
boolean isEmpty() { }
boolean waitHaveRows() { }
boolean waitRows(int count) { }
ICell cell(String value, Row row) { }
ICell cell(String value, Column column) { }
List<ICell> cellsMatch(String regex, Row row) {
}
List<ICell> cellsMatch(String regex, Column
column) { }
MapArray<String, ICell> row(String value,
Column column) { }
MapArray<String, ICell> column(String value,
Row row) { }
MapArray<String, ICell> row(int rowNum) { }
MapArray<String, ICell> row(String rowName)
{ }
List<String> rowValue(int colNum) { }
List<String> rowValue(String colName) { }
MapArray<String, ICell> column(int colNum) {
}
MapArray<String, ICell> column(String
colName) { }
List<String> columnValue(int colNum) { }
List<String> columnValue(String colName) { }
MapArray<String, SelectElement> header() { }
SelectElement header(String name) { }
List<String> headers() { }
List<String> footer() { }
List<ICell> getCells() { }
void clean() { }
void clear() { }
ITable useCache(boolean value) { }
ITable useCache() { }
Table clone() { }
Table copy() { }
ITable hasAllHeaders() { }
ITable hasNoHeaders() { }
ITable hasOnlyColumnHeaders() { }
ITable hasOnlyRowHeaders() { }
ITable hasColumnHeaders(List<String> value)
{ }
<THeaders extends Enum> ITable
hasColumnHeaders(Class<THeaders> headers)
{ }
ITable hasRowHeaders(List<String> value) { }
<THeaders extends Enum> ITable
hasRowHeaders(Class<THeaders> headers) { }
ITable setColumnsCount(int value) { }
ITable setRowsCount(int value) { }
24

public class Header : Section
[JPage (Url = "/index.html", Title = “Good site") ]
public class HomePage : WebPage
[JSite (Domain = “http://epam.com/") ]
public class EpamSite : WebSite
public class LoginForm : Form
public class SearchBar : Search
public class Alert : Popup
public class Navigation : Pagination
26
COMPOSITE ELEMENTS

[JPage (domain = “http://epam.com/") ]
public class EpamSite : WebSite {
[JPage (Url = "/index.html") ]
public static HomePage homepage;
[JPage (Url = "/login", Title = “Login page") ]
public static LoginPage loginPage;
[FindBy (Сss=“.nav”) ]
public static Menu navigation;
}
27
WEB SITE
public static void SetUp() {
WebSite.Init(typeof(EpamSite));
}

[JPage (Url = "/main", Title = "Good site", UrlTemplate = “/main?d{10}“,
UrlCheckType = MATCH, TitleCheckType = CONTAINS) ]
public class HomePage : WebPage
28
WEB PAGE
homepage.Open();
homepage.CheckOpened();
homepage.IsOpened();
homepage.Refresh();
homepage.Back();
homepage.Forward();
homepage.AddCookie();
homepage.ClearCache();
USAGE

public class Header : Section {
[FindBy (Сss=“.submit”) ]
[FindBy (Сss=“.followMe”) ]
public Link followMe;
[FindBy (Сss=“.navigation”) ]
public Menu navigation;
public void openAbout() {
followMe.Click();
navigation.Select(ABOUT);
}
}
29
SECTION
header.Submit.Click();
header.Menu.IsSelected();
header.OpenAbout();
USAGE

EDT: DATA DRIVEN TESTING
31
 Provide List<User> for test

EDT: PRECONDITIONS
32
0. Have DefaultUser in DB

EDT: FILL AND SUBMIT
33
1. Login with DefaultUser

EDT: FILL AND SEND
34
2. Submit Contact Us Form for DefaultUser

EDT: EXTRACT
35
3. Get Act. Opening from Vacancy table

EDT: VALIDATE
36
3. Get Act. Opening from Vacancy table
4. Assert Act. Opening equals to Exp. Opening
ExpectedActual

public class LoginForm extends Form<User> {
[FindBy (Сss=“.login”)
public TextField Login;
[FindBy (Сss=“.psw”)
[FindBy (Сss=“.submit”)
public Button Submit;
[FindBy (Сss=“.cancel”)
public Button Cancel;
}
37
FORM
public class User {
public String Login = “roman”;
public String Password = null;
}
[Test]
public class SimpleTest(User User) {
loginForm.login(user);
…
}

[Test]
public void FormTest(User Admin) {
LoginForm.LoginAs(Admin);
Filter.Select(Admin.name);
Assert.Each(Results).Contains(Admin.Name);
Results.get(1);
PayForm.Submit(Admin.CreditCard);
Assert.AreEquals(DB.Transactions[1]),
Admin.CreditCard);
}
38
ENTITY DRIVEN TESTING
LoginForm.Fill(User);
LoginForm.Submit(User);
LoginForm.Verify(User);
LoginForm.Check(User);
LoginForm.Cancel(User);
LoginForm.Save(User);
LoginForm.Publish(User);
LoginForm.Search(User);
LoginForm.Update(User);
…
USAGE

[FindBy (Css = “.offers") ]
public Table<Job, JobRecord> Offers = new Table {
Row = By.Css(".value"),
Column = By.TagName(“li"),
Header = new [] {“ID", “Title", “Apply”}
};
39

[FindBy (Css = ".list.ui-sortable") ]
public Elements<FilmCard> FilmCards;
FilmCards[name].Title.GetText();
40
ELEMENTS

41
OTHER UI OBJECTS
public class SearchBar : Search { }
public class Navigation : Pagination { }
public class Confirmation : Popup { }
…
public class MyCustom : CustomObject { }
// implements IComposite

48
TEST ANY UI
Your Engine (Driver)

49
JDI ARCHITECTURE
Commons
Core
Matchers
Web, Mobile, Gui …
public interface ICheckBox
extends IClickable, ISetValue {
void Check();
void Uncheck();
boolean IsChecked();
}
INTERFACES
IElement
ISelector
IComposite
IPage
IHasValue
ISetValue
IButton
ICheckBox
IDatePicker
IFileInput
IImage
ILabel
ILink
IText
ITextArea
ITextField
ICheckList
IComboBox
IDropDown
IDropList
IForm
IGroup
IMenu
IPage
IPagination
IPopup
IRadioButtons
ISearch
ISelector
ITabs
ITextList

• Write test code faster up to 5 times
• Average result around 2.8 times
• 4.7 times speedup on the project with standard implementation
• Produce less amount of test code (loc) up to 3 times
• Average result around 2.1 times
• 2.8 times reduction on the project with standard implementation
• Achieve higher clearness of tests
• Decrease of support time for test projects
• Lowering of project entry barrier for newcomers
• Complete projects with higher quality
• Based on 70 % answers in survey
51
JDI BENEFITS

• Reuse investments from one Project on another
• Based on 5 years of work and more than 30 projects that already use JDI
• Save up to 80% test effort by migrating tests to other Platforms
• Based estimated average scope reductions for all test process stages
• Example: migrate Web tests to Mobile platform
• Can be used in most of projects with UI Automation
• Actually we have no projects where JDI is not applicable. The only reason why not all of our
projects use JDI is Client requirements
• Save up to 30-40% money from whole test process
• Based on average calculation of scope reductions for all test process stages
52
JDI BENEFITS

LOG IN BDD STYLE
I select ‘jacket’ ProductType on ProductPage
I select ‘500$’ Price on ProductPage
I check ‘black’ and ‘white’ Colors on ProductPage
54
ProductPage.ProductType.select(«jacket»);
ProductPage.Price.select(«500$»);
ProductPage.Colors.check(«black», «white»);

• Chrome plugin
• Get ui elements to page object in browser
• Auto generation
55
GENERATED PAGE OBJECTS
public class LoginForm extends Form<User> {
@FindBy (css=“.login”)
public TextField login;
@FindBy (css=“.psw”)
public TextField password;
@FindBy (css=“.submit”)
public Button login;
}

56
SERVICES PAGE OBJECTS
@ServiceDomain(“http://service.com”)
public class ServiceExample {
@GET (“/color/get”)
public RestMethod getColor;
@POST (“/color/change/100”)
public RestMethod changeColor;
}
Auto generation by WSDL

59
SUPPORT MAIN UI DEV FRAMEWORKS

64
CONTACTS
http://jdi.epam.com/
https://vk.com/jdi_framework
https://github.com/epam/JDI
roman.Iovlev
roman_iovlev@epam.com

Роман Иовлев «Open Source UI Automation Tests on C#»

More Related Content

What's hot (17)

Similar to Роман Иовлев «Open Source UI Automation Tests on C#» (20)

More from SpbDotNet Community (20)

Recently uploaded (20)

Роман Иовлев «Open Source UI Automation Tests on C#»

Editor's Notes