Easy tests with Selenide and Easyb

50 %
50 %
Information about Easy tests with Selenide and Easyb

Published on March 5, 2014

Author: yashaka

Source: slideshare.net


Selenide is simple and powerful in use wrapper-library over Selenium. But what the point just of shorter lines of code? In this talk we will see how to tame your webui mustang with Selenide and put it into fence of simple BDD stories with Easyb. We also consider pros and cons of the approach and compare to available alternatives.

Easy:) Tests with Selenide and Easyb Iakiv Kramarenko

Conventions :) ● Sympathy colors***: Green = Orange Red = = *** often are subjective and applied to specific context ;)

● At project with no Web UI automation, no unit testing ● With 4(5) Manual QA – ● Using checklists + long detailed End to End test cases With 1 QA Automation found

Testing single page web app ● Ajax ● only <div>, <a>, <input> – Inconsistent implementation ● No confident urls ● One current Frame/Page with content per user step – Deep structure: ● – Authorization > Menus > SubMenus > Tabs > Extra > Extra Modal dialogs

Met Requirements ● Automate high level scenarios – – ● use AC from stories existed Manual Scenarios Use 3rd party solutions – ● Java Desired Involve Manual QA – – ● provide easy to use solution BDD Desired In Tough Deadlines :)

Dreaming of framework... ● Fast in development – Using instruments quite agile to adapt to project specifics ● Extremely easy to use and learn ● Simple DSL for tests ● BDD – light and DRY as much as possible

“Raw” Webdriver with tunings (HtmlElements, Matchers, etc.) ● No convenient and concise Ajax support out of the box ● Code redundancy – Driver creation – Finding elements – Assert element states ● Harmcrest Matchers are easy, but assertThat() knows nothing about Ajax – HtmlElements gives powerful but bulky “waiting” decorators (see links [1][2])

Concordion ● Hard to extend – Custom commands (asserts) <html xmlns:concordion="http://www.concordion.org/2007/concordion"> <body> <p concordion:assertEquals="getGreeting()">Hello World!</p> </body> </html>

Thucydides ● No convenient Ajax support – Asserts and Conditions are bound ● ● Framework, not a Lib – Not agile ● ● Hard to extend It's hard to use some patterns (e.g. LoadableComponent) Monstrous Manual :)

= Redundancy


Easy:) Instruments

@Test public void userCanLoginByUsername() { open("/login"); $(By.name("user.name")).setValue("johny"); $("#submit").click(); $(".loading_progress").should(disappear); $("#username").shouldHave(text("Hello, Johny!")); }

Selenide Pros ● Wrapper over Selenium with Concise API ● Lib, not a Framework – ● You still have your raw WebDriver when needed should style asserts – Independent from Conditions – Waiting for conditions (Ajax friendly) ● Screenshot reporting on each failed should ● Screenshot API – – ● Providing screenshots' context Get all screenshots for context Actively supported by authors

Killer Feature Selenide Conditions

public static final Condition checked = new Condition("checked") { @Override public boolean apply(WebElement element) { return isChecked(element); } @Override public String actualValue(WebElement element) { return isChecked(element) ? "checked" : "unchecked"; } @Override public String toString(){ return "checked"; } };

Or even shorter public static final Condition checked = new Condition("checked") { @Override public boolean apply(WebElement element) { return isChecked(element); } };

Custom Condition Examples


Implementation public static final Condition checked = Condition.hasClass("checked"); public static final Condition enabled = Condition.hasNotClass("disabled"); public static final Condition expanded = Condition.attribute("area-expanded", "true");

Usage showPasswordCheckBox().shouldBe(not(checked)); applyButton().shouldBe(enabled); treeItem.shouldBe(expanded);

Usage: is public static void ensureExpanded(SelenideElement item){ if (item.is(not(expanded))){ } } expand(item);

Own implementation

Implementation (1) public static final Condition inRadioMode(final String radioMode){ return new Condition("in radio mode: " + radioMode) { @Override public boolean apply(WebElement webElement) { boolean res = true; for(WebElement mode: Mode.modes(webElement)){ if (Mode.value(mode).equals(radioMode)){ res = res && mode.getAttribute("class").contains("active"); } else { res = res && ! } } } }; } return res; mode.getAttribute("class").contains("active");

Implementation (2) public static final Condition faded = new Condition("faded with backdrop" ) { @Override public boolean apply(WebElement element) { return backDropFor(element).exists(); } };

Implementation (3) public static Condition leftSliderPosition(final Integer position) { return new Condition("left slider position " + position) { @Override public boolean apply(WebElement webElement) { return getLeftSliderCurrentPosition(webElement).equals(position); } }; }

Usage tabContainer().shouldBe(faded); accessRadioButtons().shouldBe(inRadioMode(PRIVATE)); scheduler.shouldHave(leftSliderPosition(100));

Composition* * public static final will be omitted for simplicity

Implementation Condition loadingDialog = condition(loadingDialog(), exist); Condition applyButtonDisabled = condition(primeBtn(), disabled); Condition cancelButtonDisabled = condition(scndBtn(), disabled); Condition processed = with_(no(Modal.dialog())); Condition loaded = and(processed, with_(no(loadingDialog)), with_(applyButtonDisabled)); Condition savedForSure = and(loaded, with_(saveSuccessMsg())); Condition failedToSave = and( processed, with_(no(loadingDialog)), with_(not(applyButtonDisabled)), with_(no(saveSuccessMsg())), with_(not(cancelButtonDisabled)), with_(saveErrorsMsg()));

Usage //fill page with valid/invalid data... Page.save() Page.shouldBe(and( failedToSave, with(usernameValidation(), currentPassValidation()), with(no(newPassValidation(), matchPassValidation())))) //fix errors and save... Page.shouldBe(savedForSure)

Selenide Cons ● Young:) – Many things can be improved ● Error messages ● Condition helpers ● Screenshot API – – ● Tones of them have been resolved so far Others can be implemented as your own extensions Not all-powerfull – For some things you will still need raw WebDriver

Easyb Pros ● Gherkin (given/when/then) and its implementation live at the same file – better maintainability – more DRY code ● no implementation => “pending” test ● simple but nice looking reports ● groovy as a script language for tests – scenarios are ordered

Easyb Cons ● bad support of framework from authors. ● some features are broken – ● no tags per scenario/step – ● ● ● before_each only tags per story Stack trace of error messages is clipped No out of the box way to put listeners on steps/scenarios “Shared steps” feature is present but not quite handy

Easyb Selenide Integration

Problem Selenide shoulds vs Easyb shoulds Easyb catches any 'should' (shouldBe, shouldHave, ...) except “should” and “shouldNot” showPasswordCheckBox().shouldNot(checked); //Less readable:(

Solution => Decorators showPasswordCheckBox().shouldNot(be(checked)); showPasswordCheckBox().should(be(not(checked)));

All Together :)

Preconditions to BDD Team is competent :) ● ● PO knows what is Criteria of Good Requirement Manual QA knows how to write “Automatable” Scenarios

Pending Easyb Story by PO description "Products List page" scenario "Add new product", { given "On Products List page" then "new product can be added" }

Pending Detailed Easyb Story by Manual QA description "Products List page" scenario "Add new product", { given "On Products List page" and "No custom product with 'Product_1' name exist" then "new product with 'Product_1' name can be added" and "after relogin still present" }

Implemented Easyb Story description "ProductsList test" tags "functional" BaseTest.setup() scenario "Add new product", { given "On ProductsList page",{ ProductsList.page().get() } and "No custom product with '" + TEST_PRODUCT + "' name exist", { Table.ensureHasNo(cellByText(TEST_PRODUCT)) } then "new product with '" + TEST_PRODUCT + "' name can be added", { ProductsList.addProductForSure(TEST_PRODUCT) } and "after relogin still present", { cleanReLogin() Table.cellByText(TEST_PRODUCT).should(be(visible)); } }

Easyb Report

Failed Easyb Report

Alternative: TestNG test public class ProductManagement extends AbstractTest { @Test public void testNewProductCanBeAdded() { ProductsList.page().get(); Table.ensureHasNo(cellByText(TEST_PRODUCT)); ProductsList.addProductForSure(TEST_PRODUCT); cleanReLogin(); Table.cellByText(TEST_PRODUCT).should(Be.visible); } }

Alternative: TestNG Report

Failed TestNG Report

When Easyb ? ● “Somebody” wants Gherkin – Automation resources are limited, and help may come from PO or Manual QA providing detailed 'steps to code' ● Detailed reporting of test steps ● Ordered tests execution (as present in the file)

When TestNG/Junit ? ● When you have strong 'agile' devs/automation which know why what and how to test and do write tests. – Hence you never need pretty looking reports to please your manager customer because you just have high quality product.

Ideas for improvements ● Kill Kenny – if he is the only who wants Gherkin:) – and stay KISS with TestNG/Junit ● Contribute to Easyb:) ● Bless Selenide:) – Authors will contribute nevertheless


Resources, Links ● ● ● Src of example test framework: https://github.com/yashaka/gribletest Application under test used in easyb examples: http://grible.org/download.php Instruments – http://selenide.org/ – http://easyb.org/

● To Artem Chernysh for implementation of main base part of the test framework for this presentation – ● To Maksym Barvinskyi for application under test – ● https://github.com/elaides/gribletest http://grible.org/ To Andrei Solntsev, creator of Selenide, for close collaboration on Selenide Q&A, and new features implemented:)

Contacts ● yashaka@gmail.com ● skype: yashaolin ● http://www.linkedin.com/in/iakivkramarenko

Add a comment

Related presentations

Related pages

Easy Tests with Selenide and Easyb - Selenium Camp

Iakiv Kramarenko. Cogniance, Ukraine. Enthusiast traveller, photographer, capoerista, dancer and a lot more. Works as QA Automation Engineer. Passionate of ...
Read more

easyb makes it easy, man

... in which the word test is replaced by the word ... Easy? easyb specifications are written in Groovy and run via a Java runner that can be ...
Read more

Selenium Tutorial: What is Selenide

selenium tutorial, selenium webdriver, ... Easy Tests with Selenide and Easyb. 6. Selenide - just ideal for handling Ajax in tests. ...
Read more

Is easyb Easy? - DZone Agile - DZone: Programming & DevOps ...

Is easyb Easy? In my opinion, it was very . What do you think? Give it a try, ... [easyb] Running login service test story (LoginServiceTest.story)
Read more

easyb makes it easy, man

... (and BDD concepts) can seriously assist your test-first-development desires; ... Coding this scenario in easyb is easy too-- just add it to the ...
Read more

Selenide | LinkedIn

Senior Software Test Automation Engineer ... selenide (CIGS) thin film module it is easy to see that every ... Easy tests with Selenide and Easyb. 2,057 ...
Read more

Grails Plugin: EasyB + Grails Testing

Ending in one of these suffixes will ensure you easyb tests don't clash with other test plugins. Best Practice It is best practice to put your tests ...
Read more

Speaking history for Iakiv Kramarenko | Lanyrd

Selenium Camp 2013. Ukraine Ukraine, Kiev 28th February to 1st March 2014. Easy Tests with Selenide and Easyb
Read more