Escape from the automation hell

Escape from
the automation hell

DSL
A domain-specific language (DSL) is a computer
language specialized to a particular application domain.
@Test
public void bookShouldBeSearchedByName() {
loginToBookStoreAs(regularUser);
openBookStorePage();
enterSearchCriteria("99 Francs");
searchBooks();
assertFalse(isEmptySearchResult());
}

Benefits of DSL Approach
● High-level - tests are in the language of product
management, at the user level
● Readable - product management can understand them
● Writable - easy for developer or QA to write new test
● Extensible - tests base is able to grow with DSL

Tips and Tricks of DSL Approach
● Use test class hierarchy or test helpers
● Use builders, visitors and other design patterns
● Reuse domain model from application
● Some common methods move to base test class
● Minimize usage of driver instance in tests

What is really Test Automation Framework?
Test Automation Framework (TAF) — the environment required for test
automation including test harnesses and artifacts such as test libraries.
Test Automation Solution (TAS) — the realization / implementation of a TAA
including test harnesses and artifacts such as test libraries.
Test Automation Architecture (TAA) — an instantiation of gTAA to define the
architecture of a TAS.
Generic Test Automation Architecture (gTAA) — providing a blueprint for test
automation solutions.

What is really Test Automation Framework?

What is Test Automation Engineer?
Test Automation Engineer (TAE) — the person who is
responsible for the design of a Test Automation Architecture
(TAA), including the implementation of the resulting Test
Automation Solution (TAS), its maintenance and technical
evolution.
TAE == Software Developer in Test

What is really WebDriver?
Selenium is
a suite of tools to automate web browsers
across many platforms.

What is really WebDriver?
Selenium automates browsers. That's it!

UI Test Automation Framework
Selenium inside
http://selenide.org
https://github.com/codeborne/selenide

Selenide > Main Goals
KISS principle in action
No unnecessary code → No unnecessary maintenance
Less to learn → Easier to use

Selenide > Keynote
Create a browser
Selenium WebDriver:
DesiredCapabilities desiredCapabilities = DesiredCapabilities.htmlUnit();
desiredCapabilities.setCapability(HtmlUnitDriver.INVALIDSELECTIONERROR, true);
desiredCapabilities.setCapability(HtmlUnitDriver.INVALIDXPATHERROR, false);
desiredCapabilities.setJavascriptEnabled(true);
WebDriver driver = new HtmlUnitDriver(desiredCapabilities);
Selenide:
open("https://catalog.onliner.by");

Selenide > Keynote
Shutdown a browser
Selenium WebDriver:
if (driver != null) {
driver.close();
}
Selenide:
// Do not care! Selenide closes the browser automatically
With Selenide You don't need to operate with Selenium WebDriver directly.
WebDriver will be automatically created/deleted during test start/finished.

Selenide > Keynote
Find element by id
Selenium WebDriver:
WebElement customer = driver.findElement(By.id("customerContainer"));
Selenide:
WebElement customer = $("#customerContainer");
or a longer conservative option:
WebElement customer = $(By.id("customerContainer"));

Selenide > Keynote
Assert that element has a correct text
Selenium WebDriver:
assertEquals("Customer profile",
driver.findElement(By.id("customerContainer")).getText());
Selenide:
$("#customerContainer").shouldHave(text("Customer profile"));

Selenide > Keynote
Ajax support (waiting for some event to happen)
Selenium WebDriver:
FluentWait<By> fluentWait = new FluentWait<By>(By.tagName("TEXTAREA"));
fluentWait.pollingEvery(100, TimeUnit.MILLISECONDS);
fluentWait.withTimeout(1000, TimeUnit.MILLISECONDS);
fluentWait.until(new Predicate<By>() {
public boolean apply(By by) {
try {
return browser.findElement(by).isDisplayed();
} catch (NoSuchElementException ex) {
return false;
}
}
});
assertEquals("John", browser.findElement(By.tagName("TEXTAREA")).getAttribute("value"));
Selenide:
$("TEXTAREA").shouldHave(value("John"));
This command automatically waits until element gets visible AND gets expected value.
Default timeout is 4 seconds and it's configurable.

Selenide > Keynote
Assert that element does not exist
Selenium WebDriver:
try {
WebElement element = driver.findElement(By.id("customerContainer"));
fail("Element should not exist: " + element);
}
catch (WebDriverException itsOk) {}
Selenide:
$("#customerContainer").shouldNot(exist);

Selenide > Keynote
Looking for element inside parent element
Selenium WebDriver:
WebElement parent = driver.findElement(By.id("customerContainer"));
WebElement element = parent.findElement(By.className("user_name"));
Selenide:
$("#customerContainer").find(".user_name");

Selenide > Keynote
Looking for Nth element
Selenium WebDriver:
driver.findElements(By.tagName("li")).get(5);
Selenide:
$("li", 5);

Selenide > Keynote
Select a radio button
Selenium WebDriver:
for (WebElement radio : driver.findElements(By.name("sex"))) {
if ("woman".equals(radio.getAttribute("value"))) {
radio.click();
}
}
throw new NoSuchElementException("'sex' radio field has no value 'woman'");
Selenide:
selectRadio(By.name("sex"), "woman");

Selenide > Keynote
Take a screenshot
Selenium WebDriver:
if (driver instanceof TakesScreenshot) {
File scrFile = ((TakesScreenshot) webdriver)
.getScreenshotAs(OutputType.FILE);
File targetFile = new File("c:temp" + fileName + ".png");
FileUtils.copyFile(scrFile, targetFile);
}
Selenide:
takeScreenShot("my-test-case");

Selenide > Three simple things
1. Open the page
2. $(element).doAction()
3. $(element).check(condition)
open("/login");
$("#submit").click();
$(".message").shouldHave(text("Hello"));

Selenide > Use the power of IDE
Selenide API consists of few classes. Open your IDE and start typing.
Just type: $(selector). - and IDE will suggest you all available options.
Use the power of todays development environments instead of bothering with
documentation!

Selenide > Selenide API
open(String URL) opens the browser (if yet not opened) and loads the
URL
$(String cssSelector) – returns object of the SelenideElement class that
represents first element found by CSS selector on the page.
$(By) – returns "first SelenideElement" by the locator of the By class.
$$(String cssSelector) – returns object of type ElementsCollection that
represents collection of all elements found by a CSS selector.
$$(By) – returns "collection of elements" by the locator of By type.
import static com.codeborne.selenide.Selenide.* for readability

Selenide > Selenide API > Selectors
com.codeborne.selenide.Selectors
$(byText("Login")).shouldBe(visible));
$(byXpath("//div[text()='Login']")).shouldBe(visible);
$(By.xpath("//div[text()='Login']")).shouldBe(visible);
Selector
byText - search element by exact text
withText - search element by contained text (substring)
by(attributeName, attributeValue) - search by attribute’s name and value
byTitle - search by attribute “title”
byValue - search by attribute “value”
Xpath
etc.

Selenide > Selenide API
Perform some action on it:
$(byText("Sign in")).click();
Or even several actions at once:
$(byName("password")).setValue("qwerty").pressEnter();
Check some condition:
$(".welcome-message").shouldHave(text("Welcome, user!"));
When you needed an element in Element Collection of a same type:
$$("#search-results a").findBy(text("selenide.org")).click();

Selenide > Selenide API > Selenide Elements
Selenide Elements
SelenideElement
ElementsCollection
$ $$

Selenide > Selenide API > Selenide Element
com.codeborne.selenide.SelenideElement
Actions methods
Search methods
Element statuses methods
Check methods (Assertions)
Conditions methods
Selenide Explicit Waits methods
Other useful methods

Actions methods
click()
doubleClick()
contextClick()
hover()
setValue(String) / val(String)
pressEnter()
pressEscape()
pressTab()
selectRadio(String value)
selectOption(String)
dragAndDropTo(String)
…
Search methods
find(String cssSelector)
/ $(String cssSelector)
find(By) / $(By)
findAll(String cssSelector)
/ $$(String cssSelector)
findAll(By) / $$(By)

getValue() / val()
data()
attr(String)
text()
innerText()
getSelectedOption()
getSelectedText()
getSelectedValue()
isDisplayed()
exists()
...
should(Condition)
shouldBe(Condition)
shouldHave(Condition)
shouldNot(Condition)
shouldNotBe(Condition)
shouldNotHave(Condition)

Selenide Explicit Waits methods
waitUntil(Condition,
milliseconds)
waitWhile(Condition,
milliseconds)
Other useful methods
uploadFromClasspath(String
fileName)
download()
toWebElement()
uploadFile(File…)

● visible / appear
● present / exist
● hidden / disappear
● readonly
● name
● value
● type
● id
● empty
com.codeborne.selenide.Condition
$("input").shouldHave(exactText("Some text"));
Condition
● attribute(name)
● attribute(name, value)
● cssClass(String)
● focused
● enabled
● disabled
● selected
● matchText(String regex)
● text(String substring)
● exactText(String wholeText)
● textCaseSensitive(String substring)
● exactTextCaseSensitive(String wholeText)

com.codeborne.selenide.ElementsCollection
Selector methods
Conditions methods
Selenide > Selenide API > Elements Collection

Selector methods
filterBy(Condition) – returns
collection with only those
original collection elements
that satisfies the condition,
excludeWith(Condition)
get(int)
findBy(Condition)
size()
isEmpty()
getTexts()

shouldBe(CollectionCondition)
shouldHave(CollectionCondition)
Assertions also play role of explicit waits.
They wait for condition
(e.g. size(2), empty, texts("a", "b", "c")) to be
satisfied until timeout reached (the value
of Configuration.collectionsTimeout
that is set to 6000 ms by default).
Conditions methods
empty
size(int)
sizeGreaterThan(int)
sizeGreaterThanOrEqual(int)
sizeLessThan(int)
sizeLessThanOrEqual(int)
sizeNotEqual(int)
texts(String... substrings)
exactTexts(String... wholeTexts)

Selenide > Selenide API > WebDriver Runner
com.codeborne.selenide.WebDriverRunner
This class defines some browser management methods:
isChrome()
isFirefox()
isHeadless()
url()
source()
getWebDriver() - returns the WebDriver instance (created by Selenide
automatically or set up by the user), thus giving to the user the raw API
to Selenium if needed
setWebDriver(WebDriver) - tells Selenide to use driver created by the
user. From this moment the user himself is responsible for closing the
driver.

Selenide > Selenide API > Configuration
com.codeborne.selenide.Configuration
Сonfiguration options to configure execution of Selenide-based tests, e.g.:
timeout: waiting timeout in milliseconds, that is used in explicit
(should/shouldNot/waitUntil/waitWhile) and implicit waiting for
SelenideElement; set to 4000 ms by default; can be changed for
specific tests, e.g. Configuration.timeout = 6000;
collectionsTimeout - waiting timeout in milliseconds, that is used in
explicit (should/shouldNot/waitUntil/waitWhile) and implicit waiting for
ElementsCollection; set to 6000 ms by default; can be changed for
specific tests, e.g. Configuration.collectionsTimeout = 8000;
browser (e.g. "chrome", "ie", "firefox")
baseUrl
...

UI Test Automation Framework
Selenium inside
http://jdi.epam.com
https://github.com/epam/JDI
https://github.com/epam/JDI-Examples

JDI > Main Goals
Already implemented actions for most used elements
Detailed UI actions log
Flexible for any UI on any Framework or Platform
Short and obvious UI Objects (Page Objects)

JDI > Simple Test
loginPage.open();
loginPage.loginForm.login(admin);
searchPage.search.find("Cup");
Assert.AreEqual(
resultsPage.products.count(),
expected);

JDI > Simple Test
productPage.productType.Select("jacket");
productPage.price.select("500$");
productPage.colors.check("black", "white");
Assert.isTrue(
productPage.label.getText(),
"Massimo Dutti Jacket")

JDI > JDI API
Elements
Simple
Complex
Composite

JDI > JDI API > Simple Elements

JDI > JDI API
Complex Elements

JDI > JDI API > Complex Elements

JDI > JDI API > Complex Elements > Enums

JDI > JDI API > Typified elements
Code readability
Clear behavior
Union of all element’s locators
Union of element and its actions
Detailed logging

JDI > JDI API
Composite Elements

JDI > JDI API > Composite Elements

Selenide vs JDI > Language support
Native JNI Selene
Native Native
Not
supported

Escape from the automation hell

Recommended

Recommended

More Related Content

What's hot

What's hot (19)

Similar to Escape from the automation hell

Similar to Escape from the automation hell (20)

Recently uploaded

Recently uploaded (20)

Escape from the automation hell