CodeFest 2013. Ерошенко А. — Фреймворк Html Elements или как удобно взаимодействовать с веб-интерфейсами в тестах

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

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);
}

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();
}
}

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

Загромождение
public class AutoHomePage {
@FindBy(name = "text")




@FindBy(xpath = "//div[@class='b-domik__button']//input")
private WebElement loginButton;

@FindBy(name = "twoweeks")
private WebElement rememberMeCheckBox;


Недостатки

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

Tests

Steps

PageObject

Element

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

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

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

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

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


@FindBy(className = "b-form-button__input")

}
}

Форма авторизации
@Block(@FindBy(className = "b-domik"))
public class AuthorizationForm extends HtmlElement {




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

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




@FindBy(name = "b-form-button__input")

PageFactory.initElements(driver, this);
}

...
}

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

private SearchArrow searchArrow;

private AuthorizationForm authorizationForm;

HtmlElementLoader.populatePageObject(this, driver);
}

searchArrow.searchFor(request);
}

public void login(String login, String password) {
authorizationForm.login(login, password);
}
}

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

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

@FindBy(className = "b-search")

private SearchResultsBlock searchResultsBlock;

public SearchResultsPage(WebDriver driver) {
HtmlElementLoader.populatePageObject(this, driver);
}

searchArrow.searchFor(request);
}

public boolean isSearchResultsBlockDisplayed() {
return searchResultsBlock.isDisplayed();
}
}


@FindBy(className = "b-search")

}


...

}

Типизация
GodeFest

GodeFest



@FindBy(xpath = "//div[@class='i-popup__content']//li")
private List<WebElement> suggest;

public void searchBySuggest(String request, int suggestItemNumber) {
suggest.get(suggestItemNumber).click();
}
}

GodeFest

private WebElementrequestInput;
TextInput requestInput;

Button searchButton;

@FindBy(className = "i-popup__content")
@FindBy(xpath = "//div[@class='i-popup__content']//li")
private List<WebElement> suggest;
Suggest suggest;

suggest.selectByIndex(suggestItemNumber);
suggest.get(suggestItemNumber).click();
}
}

Стандартные

TextBlock
TextInput
Button
Link

Расширенные

Checkbox
Radio Form
Select Table

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(){...}
}

Radio

public class Radio extends TypifiedElement {

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

public WebElement getSelectedButton(){...}

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

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

}

public class Select extends TypifiedElement {

public boolean isMultiple(){...}
Select
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){...}
}

Form
public 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

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

}


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

Table
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
public class SomeSecretePage {

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

}

public class SearchUserSteps {

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

GodeFest

private TextInput requestInput;

private Button searchButton;

@FindBy(className = "i-popup__content")
private Suggest suggest;

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))

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


assertThat(
onSearchPage().getSearchResults(), exist()
);
}
}



assertThat(onSearchPage().getSearchResults(),
both(exist()).and(isDisplayed()));
}
}



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

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

@Test
user.shouldSeeSearchResults(
both(exists()).and(isDisplayed())
);
}

Вывод ошибки
@Test
);
}

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

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

public class SearchResultBlock extends HtmlElement {

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

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

}


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

}

public class SearchResultsBlock extends HtmlElement {

...

}

Вывод ошибки
@Test
);
}

Expected: element existing on page
but: was SearchResultBlock

Waiter Decorator

@Test
should(exists()).whileWaitingUntil(timeoutHasExpired())
);
}

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

Action Decorator

@Test
should(exists()).after(pageRefresh(driver))
);
}

Expected: after page refresh
element existing on page

Condition Decorator

@Test
should(isDisplayed()).inCase(exists());
);
}

Expected: element displayed on page
if element exists on page

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

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


Страница


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

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

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

Технологии

Converter = LambdaJ
Step FRWK = 2CDDs
Matchers = Hamcrest

@eroshenkoam

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

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

qa-tools@yandex-team.ru

CodeFest 2013. Ерошенко А. — Фреймворк Html Elements или как удобно взаимодействовать с веб-интерфейсами в тестах

Recommended

Recommended

More Related Content

What's hot

What's hot (20)

Similar to CodeFest 2013. Ерошенко А. — Фреймворк Html Elements или как удобно взаимодействовать с веб-интерфейсами в тестах

Similar to CodeFest 2013. Ерошенко А. — Фреймворк Html Elements или как удобно взаимодействовать с веб-интерфейсами в тестах (20)

More from CodeFest

More from CodeFest (20)

Recently uploaded

Recently uploaded (20)

CodeFest 2013. Ерошенко А. — Фреймворк Html Elements или как удобно взаимодействовать с веб-интерфейсами в тестах