codefest 2013. Ерошенко А. — Фреймворк html elements или как удобно...

HtmlElements

PageObjects

Steps

PageObjects

Steps

Tests

PageObjects

Рецепт приготовления

Вкусных тестов

PageObjects

public class SearchPage { @FindBy(id = "text") private WebElement requestInput; @FindBy(xpath = "//input[@type='submit']") private WebElement searchButton;

@FindBy(name = "login") private WebElement loginInput;

@FindBy(name = "passwd") private WebElement passwordInput;

@FindBy(name = "b-form-button__input") private WebElement authorizeButton; public SearchPage(WebDriver driver) { PageFactory.initElements(driver, this); }

public void searchFor(String request) { requestInput.sendKeys(request); searchButton.click(); }

public void authorize (String login, String password) { loginInput.sendKeys(login); passwordInput.sendKeys(login); authorizeButton.click(); }}

public class CommonUserSteps {

public CommonUserSteps(WebDriver driver) { ... }

public SearchPage onSearchPage() { return searchPage; } public void loginAsCommonUser() { User user = UserFactory.getCommonUser(); onSearchPage().authorize(user.getLogin, user.getPassword); }

public void searchFor(String request) { onSearchPage().searchFor(request); }

public void shouldSeeSearchResults() { assertTrue(onSearchPage().isSearchResultsBlockDisplayed()); }}

public class SearchResultsTest { private WebDriver driver = new FirefoxDriver(); private CommonUserSteps user = new CommonUserSteps(driver); @Before public void loadPage() { driver.get("http://www.yandex.ru"); } @Test public void shouldSeeSearchResultsWhenLookingUp() { user.searchFor("CodeFest"); user.shouldSeeSearchResults(); } @After public void closeDriver() { driver.quit(); } }

Steps

Tests

PageObjects

Модель устройчива

Steps

Tests

PageObjects

Шаблонизаторы

Загромождение

public class AutoHomePage { @FindBy(name = "text") private WebElement requestInput; @FindBy(xpath = "//input[@type='submit']") private WebElement searchButton; @FindBy(name = "login") private WebElement loginInput; @FindBy(name = "passwd") private WebElement passwordInput; @FindBy(xpath = "//div[@class='b-domik__button']//input") private WebElement loginButton;

@FindBy(name = "twoweeks") private WebElement rememberMeCheckBox; @FindBy(name = "text") private WebElement requestInput; @FindBy(xpath = "//input[@type='submit']") private WebElement searchButton; @FindBy(name = "login") private WebElement loginInput; @FindBy(name = "passwd") private WebElement passwordInput; @FindBy(xpath = "//div[@class='b-domik__button']//input") private WebElement loginButton; @FindBy(name = "text") private WebElement requestInput; @FindBy(xpath = "//input[@type='submit']") private WebElement searchButton; @FindBy(name = "login") private WebElement loginInput; @FindBy(name = "passwd") private WebElement passwordInput; @FindBy(xpath = "//div[@class='b-domik__button']//input") private WebElement loginButton;

@FindBy(name = "text") private WebElement requestInput; @FindBy(xpath = "//input[@type='submit']") private WebElement searchButton; @FindBy(name = "login") private WebElement loginInput; @FindBy(name = "passwd") private WebElement passwordInput; @FindBy(xpath = "//div[@class='b-domik__button']//input") private WebElement loginButton;

@FindBy(name = "text") private WebElement requestInput; @FindBy(xpath = "//input[@type='submit']") private WebElement searchButton; @FindBy(name = "login") private WebElement loginInput; @FindBy(name = "passwd") private WebElement passwordInput; @FindBy(xpath = "//div[@class='b-domik__button']//input") private WebElement loginButton; @FindBy(name = "text") private WebElement requestInput; @FindBy(xpath = "//input[@type='submit']") private WebElement searchButton; @FindBy(name = "login") private WebElement loginInput; @FindBy(name = "passwd") private WebElement passwordInput; @FindBy(xpath = "//div[@class='b-domik__button']//input") private WebElement loginButton;




@FindBy(name = "text") private WebElement requestInput; @FindBy(xpath = "//input[@type='submit']") private WebElement searchButton; @FindBy(name = "login") private WebElement loginInput; @FindBy(name = "passwd") private WebElement passwordInput; @FindBy(xpath = "//div[@class='b-domik__button']//input") private WebElement loginButton; public void searchFor(String request) { requestInput.sendKeys(request); searchButton.click(); } public void login(String login, String password) { loginInput.sendKeys(login); passwordInput.sendKeys(password); loginButton.click(); } public void searchFor(String request) { requestInput.sendKeys(request); searchButton.click(); } public void login(String login, String password) { loginInput.sendKeys(login); passwordInput.sendKeys(password); loginButton.click(); } public void searchFor(String request) { requestInput.sendKeys(request); searchButton.click(); } public void login(String login, String password) { loginInput.sendKeys(login); passwordInput.sendKeys(password); loginButton.click(); } public void searchFor(String request) { requestInput.sendKeys(request); searchButton.click(); } public void login(String login, String password) { loginInput.sendKeys(login); passwordInput.sendKeys(password); loginButton.click(); } public void searchFor(String request) { requestInput.sendKeys(request); searchButton.click(); } public void login(String login, String password) { loginInput.sendKeys(login); passwordInput.sendKeys(password); loginButton.click(); }

public void searchFor(String request) { requestInput.sendKeys(request); searchButton.click(); } public void login(String login, String password) { loginInput.sendKeys(login); passwordInput.sendKeys(password); loginButton.click(); }





}


Недостатки

Дублирование кода


Коронное блюдо

Steps

Tests

Element

PageObject

Element

PageObject

HtmlElements

Блоки элементов

Типизация элементов

Библиотека матчеров

Element

PageObject

@Block(@FindBy(className = "b-head-search")) public class SearchArrow extends HtmlElement {

@FindBy(id = "text") private WebElement requestInput; @FindBy(className = "b-form-button__input") private WebElement searchButton; public void searchFor(String request) { requestInput.sendKeys(request); searchButton.click(); } }

Поисковая форма

@Block(@FindBy(className = "b-domik")) public class AuthorizationForm extends HtmlElement {

@FindBy(name = "login") private WebElement loginInput; @FindBy(name = "passwd") private WebElement passwordInput; @FindBy(className = "b-form-button__input") private WebElement authorizeButton; public void authorize(String login, String pass) { loginInput.sendKeys(login); passwordInput.sendKeys(password); authorizeButton.click(); }}

Форма авторизации

Element

PageObject

Главная страницаpublic class SearchPage { @FindBy(id = "text") private WebElement requestInput; @FindBy(xpath = "//input[@type='submit']") private WebElement searchButton;

@FindBy(name = "login") private WebElement loginInput;

@FindBy(name = "passwd") private WebElement passwordInput;

@FindBy(name = "b-form-button__input") private WebElement authorizeButton; public SearchPage(WebDriver driver) { PageFactory.initElements(driver, this); } ...}

public class SearchPage {

private SearchArrow searchArrow;

private AuthorizationForm authorizationForm;

public SearchPage(WebDriver driver) { HtmlElementLoader.populatePageObject(this, driver); } public void searchFor(String request) { searchArrow.searchFor(request); } public void login(String login, String password) { authorizationForm.login(login, password); }}

Главная страница

Структура страницы

public class AutoSearchPage {

@FindBy(className = "b-search") private SearchArrow searchArrow;

private SearchResultsBlock searchResultsBlock; public SearchResultsPage(WebDriver driver) { HtmlElementLoader.populatePageObject(this, driver); } public void searchFor(String request) { searchArrow.searchFor(request); } public boolean isSearchResultsBlockDisplayed() { return searchResultsBlock.isDisplayed(); } }

Переопределение

@Block(@FindBy(className = "b-head-search")) public class SearchArrow extends HtmlElement {

...

}

Переопределениеpublic class SearchPage {

@FindBy(className = "b-search") private SearchArrow searchArrow;

}

Типизация

GodeFest

Типизация

@Block(@FindBy(className = "b-head-search")) public class SearchArrow extends HtmlElement { @FindBy(id = "text") private WebElement requestInput; @FindBy(className = "b-form-button__input") private WebElement searchButton;

@FindBy(xpath = "//div[@class='i-popup__content']//li") private List<WebElement> suggest; public void searchBySuggest(String request, int suggestItemNumber) { requestInput.sendKeys(request); suggest.get(suggestItemNumber).click(); } }

Поисковая формаGodeFest

@Block(@FindBy(className = "b-head-search")) public class SearchArrow extends HtmlElement { @FindBy(id = "text") private WebElement requestInput; @FindBy(className = "b-form-button__input") private WebElement searchButton;

@FindBy(xpath = "//div[@class='i-popup__content']//li") private List<WebElement> suggest; public void searchBySuggest(String request, int suggestItemNumber) { requestInput.sendKeys(request); suggest.get(suggestItemNumber).click(); } }

@Block(@FindBy(className = "b-head-search")) public class SearchArrow extends HtmlElement { @FindBy(id = "text") private TextInput requestInput; @FindBy(className = "b-form-button__input") private Button searchButton; @FindBy(className = "i-popup__content") private Suggest suggest;

public void searchBySuggest(String request, int suggestItemNumber) { requestInput.sendKeys(request); suggest.selectByIndex(suggestItemNumber); } }


Стандартные

TextBlock

TextInput

Link

Button

Расширенные

Select

Radio

Table

Form

Checkbox

public class Checkbox extends TypifiedElement {

public WebElement getLabel(){...}

public String getLabelText(){...}

public String getText(){...}

public void select(){...}

public void deselect(){...}

public void set(boolean checked){...}

public boolean isSelected(){...}}

Checkbox

public class Radio extends TypifiedElement {

public List<WebElement> getButtons(){...}

public WebElement getSelectedButton(){...}

public void selectByValue(String value){...}

public void selectByIndex(int index){...}

}

Radio

public class Select extends TypifiedElement {

public boolean isMultiple(){...}

public List<WebElements> getOptions(){...}

public List<WebElement> getAllSelectedOptions(){...}

public WebElement getFirstSelectedOption(){...}

public void selectByVisibleText(String text){...}

public void selectByIndex(int index){...} public void selectByValue(String value){...}

public void deselectAll(){...}

public void deselectByValue(String value){...}

public void deselectByIndex(int index){...}

public void deselectByVisibleText(String text){...}}

Select

Formpublic class Form extends TypifiedElement {

public void fill(Map<String, Object> data){...}

public <T> void fill(T bean, Converter Converter){...}

protected WebElement findFiledByKey(String key){...}

protected void fillField(WebElement e, Object value){...}

public WebElement findFirstField(By by){...}

public List<WebElement> findFields(By by){...}

public List<WebElement> findSelectsBy(By by){...}

}

Form


public void loginAsCommonUser() { User user = UserFactory.getCommonUser(); HashMap<String, Object> userHash = convert(user); onSearchPage().getAuthorizationForm.fill(userHash); }}


@FindBy(className = "b-domik") private Form authorizationForm;

}

public class Table extends TypifiedElement {

public List<WebElement> getHeadings(){...}

public List<String> getHeadingsAsString(){...}

public List<List<WebElement>> getRows(){...}

public List<List<WebElement>> getColumns(){...}

public WebElement getCellAt(int i, int j){...}

public List<Map> getRowsMappedToHeadings() {...}

public List<Map> getRowsMappedToHeadings(List<String> h){...}

public List<Map> getRowsAsStringMappedToHeadings(){...}

public List<Map> getRowsAsStringMappedToHeadings(List h){...}

}

Table

Table

public class SearchUserSteps {

public List<User> findAllUsers() { Table usersTable = onSomeSecretPage().getUsersTable(); List<Map> hash = usersTable.getRowsMappedToHeadings(); List<User> users = convert(hash); return users; }}

public class SomeSecretePage {

@FindBy(className = "b-secret") private Table users;

}

Converters

@Block(@FindBy(className = "b-head-search")) public class SearchArrow extends HtmlElement { @FindBy(id = "text") private TextInput requestInput; @FindBy(className = "b-form-button__input") private Button searchButton; @FindBy(className = "i-popup__content") private Suggest suggest;

public void searchBySuggest(String request, int suggestItemNumber) { requestInput.sendKeys(request); suggest.selectByIndex(suggestItemNumber); } }


Добавление элементовpublic class Suggest extends TypifiedElement { public Suggest(WebElement wrappedElement) { super(wrappedElement); } private List<WebElement> getItems() { return getWrappedElement().findElements(By.xpath("//li")); } public void selectByIndex(int itemIndex) { getItems().get(itemIndex).click(); } public void selectByValue(String itemValue) { for (WebElement item : getItems()) { if (itemValue.equals(item.getText())) { item.click(); return; } } throw new NoSuchElementException(); } }

Конструктор

Типизированные элементы

Страница

Матчеры

Матчеры

assertThat(audience, isPayingAttention())

Матчеры

assertThat(audience, isPayingAttention())

assertThat(audience, is(not(sleeping())))

Матчеры элементов

assertThat(element, exists())



assertThat(element, hasText(“CodeFest”))




assertThat(checkBox, isSelected())




assertThat(checkBox, isSelected())

assertThat(radio, hasSelectedButton(3))



public void shouldSeeSearchResults() { assertThat( onSearchPage().getSearchResults(), exist() ); }}

Матчеры в степах


public void shouldSeeSearchResults() { assertThat(onSearchPage().getSearchResults(), both(exist()).and(isDisplayed())); }}



public void shouldSeeSearchResults(Matcher mch) { assertThat( onSearchPage().getSearchResults(), mch ); }}


@Test public void shouldSeeSearchResultsWhenLookingUp() { user.searchFor("CodeFest"); user.shouldSeeSearchResults( both(exists()).and(isDisplayed()) );}

Матчеры в тестах

Вывод ошибки@Test public void shouldSeeSearchResultsWhenLookingUp() { user.searchFor("CodeFest"); user.shouldSeeSearchResults( both(exists()).and(isDisplayed()) );}

Expected: element existing on page but: was <[[FirefoxDriver: firefox on MAC (e3b28f2e-7aa7-a241-8807-40df2a8e0b54)] -> ...]>

@Block(@FindBy(className = "b-head-search")) public class SearchResultBlock extends HtmlElement {

@Name("Список поисковых результатов") @FindBy(id = "results") private List<SearchResult> searchResults;

@FindBy(id = "info") private TextBlock searchInfo;

}

Именование элементов


@Name(“Блок поисковых результатов”) private SearchResultsBlock searchResultsBlock;

}

Переопределение

@Block(@FindBy(className = "b-head-search")) public class SearchResultsBlock extends HtmlElement {

...

}

@Test public void shouldSeeSearchResultsWhenLookingUp() { user.searchFor("CodeFest"); user.shouldSeeSearchResults( both(exists()).and(isDisplayed()) );}

Expected: element existing on page but: was SearchResultBlock

Вывод ошибки

Декораторы

@Test public void shouldSeeSearchResultsWhenLookingUp() { user.searchFor("CodeFest"); user.shouldSeeSearchResults( should(exists()).whileWaitingUntil(timeoutHasExpired()) );}

Waiter Decorator

Expected: while waiting for [30000] ms element existing on page but: was SearchResultBlock

@Test public void shouldSeeSearchResultsWhenLookingUp() { user.searchFor("CodeFest"); user.shouldSeeSearchResults( should(exists()).after(pageRefresh(driver)) );}

Action Decorator

Expected: after page refresh element existing on page but: was SearchResultBlock

@Test public void shouldSeeSearchResultsWhenLookingUp() { user.searchFor("CodeFest"); user.shouldSeeSearchResults( should(isDisplayed()).inCase(exists()); );}

Condition Decorator

Expected: element displayed on page if element exists on page but: was SearchResultBlock

71

Будущее

Библиотека элементов

Генерация блоков

Страница


@Block(@FindBy(className = "b-head-search")) public class SearchArrow extends HtmlElement { @FindBy(id = "text") private WebElement requestInput; @FindBy(className = "b-form-button__input") private WebElement searchButton; public void searchFor(String request) { requestInput.sendKeys(request); searchButton.click(); } }





Страница Блоки


Попробуйтесами

Steps

Tests

Element

PageObject

HtmlElements

Технологии

Converter = LambdaJ

Step FRWK = 2CDDs

Matchers = Hamcrest

https://groups.google.com/forum/?fromgroups#!forum/yandex-qatools-htmlelements

[email protected]

@eroshenkoam

https://github.com/yandex-qatools/htmlelements







codefest 2013. Ерошенко А. — Фреймворк html elements или как удобно...

Technology