HtmlElements – естественное расширение 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 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("PageObject");
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;
Загромождение

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

Steps
Tests
Element
PageObject

Блоки элементов
Типизация элементов
Библиотека матчеров

@Block(@FindBy(className = "b-head-search"))
public class SearchArrow extends HtmlElement {
@FindBy(className = "b-form-button__input")
searchButton.click();
}
}
Поисковая форма

@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")
}

в чем смысл
Типизация

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

@FindBy(xpath = "//div[@class='i-popup__content']//li")
private List<WebElement> suggest;
suggest.get(suggestItemNumber).click();
}
}
private TextInput requestInput;
private Button searchButton;
@FindBy(className = "i-popup__content")
private Suggest suggest;
suggest.selectByIndex(suggestItemNumber);
}
}

Стандартные
TextBlock
TextInput
Link
Button
FileInput

Расширенные
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

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>
<some_style_tags>
<input name=”login” ...>
</some_style_tags>
<some_style_tags>
<input name=”passwd” ...>
</some_style_tags>
</form>
public class User {
@WebInput("login")
public String login;
@WebInput("passwd")
public String password;
}

@FindBy(className = "b-domik")
private Form authorizationForm;
}
HashMap<String, Object> userHash = convert(user);
onSearchPage().getAuthorizationForm.fill(userHash);
}
}
HashMap<String, Object> userHash = convert(user);
onSearchPage().getAuthorizationForm.fill(userHash);
}
}
public class User {
@WebInput("login")
@WebInput("passwd")
}

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 User {
@WebInput("login")
@WebInput("passwd")
}
Login Passwd
eroshenkoam c4fmUDTmbCzy8d
autotester 7cRrTT7g

public class User {
@WebInput("login")
@WebInput("passwd")
}
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;
}

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(“Yandex”))

assertThat(checkBox, isSelected())

assertThat(checkBox, isSelected())
assertThat(radio, hasSelectedButton(3))

Технологии
Converter = LambdaJ
Step FRWK = 2CDDs
Matchers = Hamcrest

https://groups.google.com/forum/?fromgroups#!
forum/yandex-qatools-htmlelements
qa-tools@yandex-team.ru
@eroshenkoam
https://github.com/yandex-qatools/htmlelements

HtmlElements – естественное расширение PageObject

Related slideshows

More Related Content

HtmlElements – естественное расширение PageObject