Let’s talk about Atlas

Let’s talk about ATLAS
АРТЕМ СОКОВЕЦ
@SokovetsArtem
(ext. HTML Elements)

ОБ АВТОРЕ
СОКОВЕЦ АРТЕМ ВЛАДИМИРОВИЧ
Leading Engineer of AutoQA @SberTech
@SokovetsArtem
Avsokovets.sbt@sberbank.ru
#java, #kotlin #autoQA

ПЛАН
• Эволюция PO
• Открытые вопросы
• Atlas - Ваш новый путеводитель в автоматизации UI
• Основные возможности инструмента
• Модель расширений
• Выводы

ВЕРСТКА ПРИЛОЖЕНИЙ

ЭВОЛЮЦИЯ PAGE OBJECT
1. Page Object
2. Page Factory
3. Fluent/Chain of invocations
4. Page Element
5. Loadable Component
6. ScreenPlay
2009
2019

1. Page Object
2. Page Factory
4. Page Element
6. ScreenPlay
2009
2019
HTML ELEMENTS

1. Page Object
2. Page Factory
4. Page Element
6. ScreenPlay
2009
2019
HTML ELEMENTS
1. JDK 7
2. JDK 8
3. JDK 9
4. JDK 10
5. JDK 11
- A LOT OF SYNTACTIC SUGAR
- LAMBDA
- MODULES and G1 by default
- VAR
- CLEANUP

ОТКРЫТЫЙ ВОПРОС №1
public class MainPage {
@FindBy(xpath = ".//div[@class = 'header']")
private Header header;
}
public class AnyOtherPage {
}

}
public class AnyOtherPage {
}
Дублирование элементов

public class EditUserPage {
@FindBy(xpath = "//div[text()='Text_1']")
private TextBlock lastActivity;
private TextBlock blockReason;
}

public class EditUserPage {
private TextBlock lastActivity;
private TextBlock blockReason;
}
Нет параметризации у элементов

public class UserPage {
@FindBy(xpath = "//div[text()='Телефон']/input")
private UfsTextInput innerPhone;
@FindBy(xpath = "//div[text()='Email']/input")
private UfsTextInput email;
@FindBy(xpath = "//button[text()='Сохранить']")
private UfsButton save;
@FindBy(xpath = "//button[text()='Список']")
private UfsButton toUsersList;
}

public class UserPage {
@FindBy(xpath = "//div[text()='Телефон']/input")
private UfsTextInput innerPhone;
@FindBy(xpath = "//div[text()='Email']/input")
private UfsTextInput email;
@FindBy(xpath = "//button[text()='Сохранить']")
private UfsButton save;
@FindBy(xpath = "//button[text()='Список']")
private UfsButton toUsersList;
}
Однотипный код

public class MainSteps {
public void hasText (HtmlElement e, Matcher m)
public void hasValue (HtmlElement e, Matcher m)
public void linkContains (HtmlElement e, String s)
public void hasSize (List<HtmlElement> e, Matcher m)
public void hasItem (List<HtmlElement> e, Matcher m)
...
}

public class MainSteps {
public void hasText (HtmlElement e, Matcher m)
public void hasValue (HtmlElement e, Matcher m)
public void linkContains (HtmlElement e, String s)
public void hasSize (List<HtmlElement> e, Matcher m)
public void hasItem (List<HtmlElement> e, Matcher m)
...
}
Уменьшить слой с шагами

ATLAS
Atlas (Application test layouts) – новый гибкий
фреймворк для мультиплатформенных продуктов.
https://github.com/qameta/atlas

PAGE OBJECT НА ИНТЕРФЕЙСАХ
public interface MainPage extends WebPage, WithHeader {
@FindBy("//a[contains(text(), 'trial')]")
AtlasWebElement trial();
}

АРХИТЕКТУРА
ATLAS = atlas-core + atlas-webdriver + atlas-appium

ATLAS ЭЛЕМЕНТЫ
AtlasWebElement
WrapsElement
WebElement
Locatable
AtlasMobileElement

ПОДКЛЮЧЕНИЕ
dependencies {
сompile 'io.qameta.atlas:atlas-webdriver:1.+'
}
dependencies {
сompile 'io.qameta.atlas:atlas-appium:1.+'
}

ОСНОВНЫЕ ВОЗМОЖНОСТИ
Интерфейсы
вместо классов
Модель
расширений
Параметризация
элементов
Методы по
умолчанию
Множественное
наследование
Работа со
списками
Перепопытки Smart Assertions

РЕАЛИЗАЦИЯ НА КЛАССАХ
public class MainPage extends BasePage {
@ElementTitle("Логин")
@FindBy(xpath = "//xpath1")
private WebElement login;
@ElementTitle("Пароль")
@FindBy(xpath = "//xpath2")
private WebElement password;
@ElementTitle("Войти")
@FindBy(xpath = "//xpath3']")
private WebElement submit;
public ConsoleStartPage() {…}}

РЕАЛИЗАЦИЯ НА ИНТЕРФЕЙСАХ
public interface MainPage extends WebPage {
@Name("Логин")
@FindBy("//xpath1")
AtlasWebElement login();
@Name("Пароль")
@FindBy("//xpath2")
AtlasWebElement password();
@Name("Войти")
@FindBy("//xpath3")
AtlasWebElement submit();
}

ИНИЦИАЛИЗАЦИЯ PAGE OBJECT
@Before public void setUp() {
atlas = new Atlas(new WebDriverConfiguration(driver));
}
@Test public void simpleTest() {
onMainPage().open("YOUR_SITE");
onMainPage().login().sendKeys("login");
onMainPage().password().sendKeys("pass");
onMainPage().submit().click();
}
private MainPage onMainPage() {
return atlas.create(driver, MainPage.class);}
1

}
}
1
2

}
}
1
2
3

ПАРАМЕТРИЗАЦИЯ ЭЛЕМЕНТОВ

@Description("Логин")
@FindBy("//div[text()='Логин']/…/input")
AtlasWebElement login();
@Description("Пароль")
@FindBy("//div[text()='Пароль']/…/input")
AtlasWebElement password();
}

@Description("Поле ввода {{ text }}")
@FindBy("//div[text()='{{ text }}']/input")
AtlasWebElement input(@Param("text") String text);
}

ПРИМЕР
@Test
public void simpleTest() {
onMainPage().input("Логин").sendKeys("*");
onMainPage().input("Пароль").sendKeys("*");
}

МНОЖЕСТВЕННОЕ НАСЛЕДОВАНИЕ (СЛОИ)
@FindBy(xpath ="//header[contains(.,'Header')]")
}

МНОЖЕСТВЕННОЕ НАСЛЕДОВАНИЕ (СЛОИ)
public interface WithHeader {
@FindBy("//header[contains(.,'Header')]")
Header header();
}
public interface Header extends AtlasWebElement {
@FindBy(".//input[contains(@class,'header-search-input')]")
AtlasWebElement searchInput();
}

ПРИМЕР
public interface MainPage extends WithHeader
public interface AnyPage extends WithHeader
public interface MainPage extends WithHeader,
WithFooter,
WithSidebar

НАСЛЕДОВАНИЕ ЭЛЕМЕНТОВ
public interface Button extends AtlasWebElement {
@FindBy(".//a[contains(., '{{ value }}')]")
AtlasWebElement selectButton(@Param("value")
String value);
}
Button

НАСЛЕДОВАНИЕ ЭЛЕМЕНТОВ
public interface Header extends Button {
…
}
public interface Footer extends Button, Input {
…
}

@Test
onMainPage().open("https://github.com");
onMainPage().header().button("Prise").click();
onMainPage().header().input("Search").sendKeys("*");
}
ПРИМЕР

ДЕРЕВО ЭЛЕМЕНТОВ

МЕТОДЫ ПО УМОЛЧАНИЮ
onMainPage().header().withInput("GitHub").clear();
onMainPage().header().withInput("GitHub").sendKeys("*");

public interface Input extends AtlasWebElement {
@FindBy("//….")
AtlasWebElement withInput(@Param("value") String value);
default AtlasWebElement withClearInput(String value) {
withInput(value).clear();
return withInput(value);
}
}

ПРИМЕР
@Test
onMainPage().open();
onMainPage().header().withClearInput("GitHub").sendKeys("Atlas");
}

public interface Checkbox extends AtlasWebElement {
@FindBy("//…")
AtlasWebElement checkBox(@Param("value") String value);
default void selectCheckbox(String value) {
if (checkBox(value).getAttribute("class").contains("disabled")) {
checkBox(value).click();
}
}
}

РАБОТА СО СПИСКОМ ЭЛЕМЕНТОВ
ElementsCollection
@FindBy(".//…")
ElementsCollection<RepositoryCard> repositories();
onSearchPage().repositories()
.filter(AtlasWebElement::isDisplayed)
.filter(it -> it.getText().contains("Atlas"))
.get(0)
.click();

WEB SITE
public interface GitHubSite extends WebSite {
@Page
MainPage onMainPage();
@Page(url = "search")
SearchPage onSearchPage(@Query("q") String value);
@Page(url = "{profile}/{project}/tree/master/")
ProjectPage onProjectPage(@Path("profile") String
profile, @Path("project") String project);
}

WEB SITE
@Test
public void useSimpleWebSiteTest() {
onSite()
.onProjectPage("qameta", "atlas")
.contributors()
.click();
}

WEB SITE
public interface GitHubSite extends WebSite {
@Page
MainPage onMainPage();
@Page(url = "search")
SearchPage onSearchPage(@Query("q") String value);
@Page(url = "{profile}/{project}/tree/master/")
ProjectPage onProjectPage(@Path("profile")String pr,
@Path("project")String pr);
}
https://github.com/qameta/atlas/tree/master/

SCREEN
public interface SearchScreen extends Screen {
@IOSFindBy("//XCUIElement[@name='Wikipedia']")
@AndroidFindBy("//*[contains(@text,'Search…')]")
AtlasMobileElement search();
}

ИТОГИ
qПоменялась работа с Page Object;
qУшли от дублирование кода;
qСпецифические действия вынесли в элементы;
qРабота со списком элементов (ElementsCollection);
qПоддержка мобильной автоматизации.

EMBEDDED RETRY
NotFoundException
StaleElementReferenceException
OtherElementWouldReceiveTheClick

EMBEDDED RETRY
NotFoundException
StaleElementReferenceException
OtherElementWouldReceiveTheClick
Каждый раз все сначала

EMBEDDED RETRY
onSearchPage().repositories()
.filter(AtlasWebElement::isDisplayed)
.filter(it -> it.getText().contains("Atlas"))
.get(0)
.click();
1. Ищем “repositories”
2. Фильтруем
3. Фильтруем
4. Берем первый
5. Кликаем
Аналогично со списками

ГЛОБАЛЬНАЯ НАСТРОЙКА
new Atlas(…).timeouts(15000L).polling(1000L);

ЛОКАЛЬНАЯ НАСТРОЙКА ОЖИДАНИЯ
@Retry (timeout = 30000L, polling = 500L)
@FindBy("//…")
AtlasWebElement button();

НЕ ДУМАЙТЕ О ОЖИДАНИЯХ
mainSteps.shouldVisible(mainPage().header().rentLink());
mainSteps.click(mainPage().header().rentLink());
Было
Стало
onMainPage().header().button(…).click();

ИТОГИ
• Встроенные перепопытки;
• Каждый раз все сначала;
• Глобальная настройка;
• Специфическая настройка под конкретный
элемент.

Работа с утверждениями

ДВА ТИПА ПРОВЕРОК
waitUntil(Matcher matcher);should(Matcher matcher);

ПРОВЕРКА SHOULD
should(Matcher matcher);
AssertionError
waitUntil(Matcher matcher);

ПРОВЕРКА WAITUNTIL
RuntimeException
should(Matcher matcher); waitUntil(Matcher matcher);

ГРУППИРОВКА ПРОБЛЕМ

ПРИМЕР
onMainPage().header().searchInput().waitUntil(displayed(), 5);
onMainPage().header().searchInput().should(tagName("input"));

АНАЛОГИЧНЫЕ ПРОВЕРКИ ДЛЯ СПИСКОВ
should(Matcher m);waitUntil(Matcher m);

ПРИМЕР
.onSearchPage("Junit 5")
.repositories()
.waitUntil(hasSize(10))
.should(everyItem(text(containsString("junit"))

WEBDRIVER MATCHER
onSite().onMainPage().header().searchInput()
.waitUntil(displayed(), 5)
.should(tagName("input"));
http://github.com/yandex-qatools/matchers-java/

ИТОГИ
• Встроенные утверждения;
• should -> AssertionError;
• waitUntil -> RuntimeException;
• Проверки для работы со списком элементов;
• Ушли шаги с проверками.

СОБЫТИЯ
BEFORE
PASS FAIL
AFTER
onMainPage().header().button("Enterprise").click();

ИНТЕРФЕЙС LISTENER
public interface Listener extends Extension {
void beforeMethodCall(…);
void afterMethodCall(…);
void onMethodReturn(…);
void onMethodFailure(…);
}

ПРИМЕР
public void beforeMethodCall(MethodInfo m, Configuration c) {
stepUUID = UUID.randomUUID().toString();
allureLifecycle.startStep(stepUUID, new
StepResult().withName(m.toString()).withStatus(Status.PASSED));
}
public void afterMethodCall(MethodInfo m, Configuration c) {
allureLifecycle.stopStep(stepUUID);
}
public void onMethodFailure(MethodInfo m, Configuration c, Throwable t) {
allureLifecycle.updateStep(stepResult -> {
stepResult.setStatus(Status.FAILED);
});
}

КАК ПОДКЛЮЧИТЬ?
@Before
public void setUp() {
…
atlas = new Atlas(new
WebDriverConfiguration(driver, "site"))
.listener(new AllureListener());
}

ИТОГИ
• Пользовательское логирование;
• 4 События (Before, After, Pass, Fail);
• Возможность интеграции c любым репортом.

Модель расширений

EXTENSION MODEL
MethodExtension
Базовый
функционал
Пользовательский
функционал

ПЕРЕОПРЕДЕЛИТЬ ПОВЕДЕНИЕ
@FindBy("//…")
}
onMainPage().header().button("En").click();
onMainPage().header().input("RU").clear();
onMainPage().header().input("UA").sendKeys(".");

КАК СДЕЛАТЬ?
public class MyExtension implements MethodExtension {
@Override
public boolean test(Method method) {…}
@Override
public Object invoke(…) throws Throwable {…}
}

КАК ПОДКЛЮЧИТЬ?
atlas = new Atlas(…)
.extension(new MyExtension())

БАЗОВЫЕ РАСШИРЕНИЯ

ПОЛЬЗОВАТЕЛЬСКОЕ РАСШИРЕНИЕ FINDBY
@MyFindBy("id")
}

ШАГ №1
public class MyFindByExtension implements MethodExtension {
@Override
public boolean test(final Method method) {
return isAnnotated(MyFindByID.class);
}
…
}

ШАГ №2
public class MyFindByExtension implements MethodExtension {
@Override
public Object invoke(Object o, MethodInfo mi, Configuration c){
String id = method.getAnnotation(MyFindBy.class).value();
Searchontext sc = (SearchContext) proxy;
Target target = new LazyTarget(sc.findElement(By.id(id)));
return new Atlas().create(target, method.getReturnType());
}
}

ПОЛЬЗОВАТЕЛЬСКИЙ КЛИК
onMainPage().header().button("en").click()

ПРИМЕР
@Override
public boolean test(Method method) {
return method.getName().equals("click");
}
@Override
public Object invoke(Object p, MethodInfo m, Configuration c){
final WebDriver driver = c.getContext(WebDriverContext.class);
final JavascriptExecutor js = (JavascriptExecutor) driver;
js.executeScript("arguments[0].click();", p);
return p;
}

КАК ИСПОЛЬЗОВАТЬ?
atlas = new Atlas(…)
.extension(new JSClickExtension())

СТОРОННИЕ БИБЛИОТЕКИ

ИНТЕГРАЦИЯ СО СВОИМ ФРЕЙМВОРКОМ
• Определить свой loader;
• Определить decorator;
• Пользовательская Page.
https://github.com/sbtqa/page-factory-2/

ATLAS ROADMAP
• Документация;
• Исправление дефектов;
• Наполнение функционала (Store Context и т.д);
• Кросс платформенный элемент.
• Обновление до Java 11;

ВЫВОДЫ
• Новое представление PageObject на интерфейсах;
• Параметризированный элемент;
• Множественное наследование;
• Дополнительные возможности;
• Точки расширения;
• Не серебряная пуля;
• Ждем в ряды контрибьюторов;

ВОПРОСЫ
СОКОВЕЦ АРТЕМ ВЛАДИМИРОВИЧ
Leading Engineer of AutoQA @SberTech
@SokovetsArtem
Avsokovets.sbt@sberbank.ru

Let’s talk about Atlas

More Related Content

Similar to Let’s talk about Atlas (20)

Let’s talk about Atlas