Page object pattern и BaseTest

Зачем нужны Page и BaseTest классы?

Рассмотрим простой тест:

public class OurFirstTest {

  @BeforeTest
  private void settings() {
      Configuration.browser = "chrome";
  }

  @Test
  public void checkSecondPageAboutText() {
      open("https://ereoo.github.io/main-page");
      $(By.id("go_second")).click();
      $(By.id("about")).shouldHave(text("This is second test page \"SecondPage\". First test page is \"MainPage\". This is a test page filled with common HTML elements. Feel free to practice create your auto-tests."));
  }

  @AfterTest
  private void close() {
      getWebDriver().close();
  }
}

Давайте разберем проблемы этого теста:

1. Сложно создать новый тест, так как нам придется:
   • Заново указывать браузер, где будет запущен тест.
   • Заново писать локаторы элементов, которы уже описывали.
   • Опять закрывать драйвер вручную.
   • Указывать сайт.
2. Сложно вносить изминения (refactoring):
   • Если у нас будет 100+ тестов, а поменяется только один локатор, надо исправлять в 100+ местах.
3. Сложно запустить тест на других браузерах.
   • В каждом тесте придется менять значение Configuration.browser .

Решение проблемы.

Page object.

Page класс описывает страницу сайта. В проекте их столько же сколько и страниц на сайте, который тестируем. В данном примере создадим два класса MainPage и SecondPage.

public class MainPage {
    private static final By SECOND_PAGE_BUTTON_LOCATOR = By.id("go_second");

    public SecondPage clickRedirectToSecondPageButton() {
        $(SECOND_PAGE_BUTTON_LOCATOR).click();
        return new SecondPage();
    }
}

public class SecondPage {
    private static final By ABOUT_TEXT_LOCATOR = By.id("about");

    public SecondPage checkAboutText(String aboutText) {
        $(ABOUT_TEXT_LOCATOR).shouldHave(text(aboutText));
        return this;
    }
}

Рассмотрим наши классы:
Локаторы элементов и взаимодействия с ними из теста мы перенесли в методы с human readable названиями. Локаторы мы вынесли в константы, которые хранятся в начале Page класса.

На Page должны находится только простые действия, которые мы сможем использовать в других тестах.

Возникает вопрос:

• Почему мы в методах возвращаем ее или другую?

Ответ:

• Благодаря этому мы сможем получать все методы для данной страницы и не сможем обратиться к методу и элементу, которые находят на другой странице сайта. Если метод переводит нас на другую страницу, он возвращает новый объект, как пример - метод clickRedirectToSecondPageButton().

Среда разработки будет помогать, показывая после ‘.’ (точки) возможные методы для нашей Page. Написание тестов становится похожим на конструктор, где инженер из методов собирает готовый тест.

Написав два класса мы решили две проблемы:

1. Заново писать локаторы элементов, которы уже описывали.
   • Теперь можно вызвать нужный нам метод или написать новый, который будет брать нужный локатор из константы.
2. Сложно вносить изминения (refactoring):
   • Теперь достаточно изменить изменить констану в Page классе и все тесты будут использовать новый локатор.

BaseTest всему голова.

Создадим BaseTest class:

public class BaseTest {
    private static final String URL_SITE = "https://ereoo.github.io/main-page";

    public MainPage openSite() {
        selectChrome();
        open(URL_SITE);
        return new MainPage();
    }

    private void selectChrome() {
        Configuration.browser = "chrome";
    }

    @AfterTest
    public void close() {
        getWebDriver().close();
    }
}

Рассмотрим класс:

• URL_SITE - константа хронящяя url нашего сайта.
• selectChrome() - метод устанавливающий браузер для запуска
• openSite() - вызывает метод selectChrome, после открывает сайт и возвращает MainPage. Что бы мы смогли сразу работать с методами главной страницы.
• close() - будет закрывать драйвер после каждого теста.

Решили проблемы:

1. Заново указывать браузер, где будет запущен тест.
   • Указываем в одном месте и все тесты будут идти на данном браузере.
2. Закрывать драйвер вручную.
   • Драйвер будет закрываться автоматически после каждого теста.
3. Заново казывать сайт.
   • Указываем сайт один раз в константе.

Тест после доработок.

public class NoSearchResults extends BaseTest {
    private static final String ABOUT_TEXT = "This is second test page \"SecondPage\". First test page is \"MainPage\". This is a test page filled with common HTML elements. Feel free to practice create your auto-tests.";

    @Test
    public void checkSecondPageAboutText() {
        openSite()
                .clickRedirectToSecondPageButton()
                .checkAboutText(ABOUT_TEXT);
    }
}

Рассмотрим тест:

• extends BaseTest - каждый новый тест нужно наследовать от BaseTest. Мы наследуем метод openSite и close (который будет вызываться автоматически благодаря аннотации).
• openSite() - открываем сайт и получаем после ‘.’ методы с MainPage и дальше строим наш тест.

Итоги.

Мы написали хороший автоматизированный тест, который можно легко изменять. Локаторы теперь хранятся в одном месте и разделены логически по страницам. Плюс мы можем сразу задавать браузер для всех тестов в одном месте и не переживать о закрытии драйвера.

Исходный код можно найти тут: GitHub project: WEB-QA.
Branch: page-object-pattern