Введение в автоматизацию тестирования BDD с помощью Serenity и Cucumber-JVM

  In order to find items that I would like to purchase
  As a potential buyer
  I want to be able to search for items containing certain words

Давайте начнем с первого примера, описанного выше. В Cucumber сценарии хранятся в  файлах объектов, которые содержат общее описание функции, а также ряд сценариев. Файл функций для приведенного выше примера вызывается search_by_keyword.featureи выглядит примерно так:

Feature: Searching by keyword

  In order to find items that I would like to purchase
  As a potential buyer
  I want to be able to search for items containing certain words

  Scenario: Should list items related to a specified keyword
    Given I want to buy a wool scarf
    When I search for items containing 'wool'
    Then I should only see items related to 'wool'

Эти файлы функций могут быть размещены в разных местах, но вы можете уменьшить объем конфигурации, который вам нужно сделать с Serenity, если вы поместите их в  src/test/resources/features каталог.

Вы обычно организуете файлы объектов в подкаталогах, которые отражают требования более высокого уровня. Например, в следующей структуре каталогов у нас есть определения функций для нескольких функций более высокого уровня:  search  и  shopping_cart :

|----src
| |----test
| | |----resources
| | | |----features
| | | | |----search
| | | | | |----search_by_keyword.feature
| | | | |----shopping_cart
| | | | | |----adding_items_to_the_shopping_cart.feature

Cucumber запускает файлы объектов через JUnit и нуждается в специальном классе для запуска тестов, чтобы фактически запускать файлы объектов. Когда вы запускаете тесты в Serenity, вы используете CucumberWithSerenity тестовый прогон  . Если файлы компонентов находятся не в том же пакете, что и класс тестового бегуна, вам также необходимо использовать этот @CucumberOptions класс для предоставления корневого каталога, в котором можно найти файлы компонентов  . Тестовый прогон для запуска всех файлов объектов выглядит следующим образом:

package net.serenity_bdd.samples.etsy.features;

import cucumber.api.CucumberOptions;
import net.serenitybdd.cucumber.CucumberWithSerenity;
import org.junit.runner.RunWith;

@RunWith(CucumberWithSerenity.class)
@CucumberOptions(features="src/test/resources/features")
public class AcceptanceTests {}

В Cucumber каждая строка сценария Gherkin отображается на метод в классе Java, известный как определение  шага . Это использование аннотаций нравятся  @Given,  @When и  @Then матч линия в сценарии к методам Java. Вы определяете простые регулярные выражения для указания параметров, которые будут переданы в методы:

public class SearchByKeywordStepDefinitions {
    @Steps
    BuyerSteps buyer;

    @Given("I want to buy (.*)")
    public void buyerWantsToBuy(String article) {
        buyer.opens_etsy_home_page();
    }

    @When("I search for items containing '(.*)'")
    public void searchByKeyword(String keyword) {
        buyer.searches_for_items_containing(keyword);
    }

    @Then("I should only see items related to '(.*)'")
    public void resultsForACategoryAndKeywordInARegion(String keyword) {
        buyer.should_see_items_related_to(keyword);
    }
}

Эти определения шагов используют Serenity для организации кода определения шагов в более повторно используемые компоненты. @StepsАннотацию говорит Serenity , что эта переменная является библиотека Шаг. В Serenity мы используем Step Libraries, чтобы добавить слой абстракции между «что» и «как» в наших приемочных тестах. Определения шагов Cucumber описывают, «что» делает приемочный тест, в достаточно нейтральных для реализации условиях, благоприятных для бизнеса. Таким образом, мы говорим «ищет предметы, содержащие  « шерсть », а не« входит в  шерсть »«в поле поиска и нажимает на кнопку поиска». Этот многоуровневый подход облегчает понимание и сопровождение тестов и помогает создать большую библиотеку повторяющихся шагов бизнес-уровня, которые мы можем использовать в других тестах. Без этого В качестве многоуровневого подхода определения шагов имеют тенденцию очень быстро становиться очень техническими, что ограничивает повторное использование и затрудняет их понимание и поддержку.

Файлы определений шагов должны находиться внутри или под пакетом, содержащим бегуны сценария:

Библиотека шагов Serenity — это обычный Java-класс с методами, помеченными  @Step аннотацией, как показано здесь:

public class BuyerSteps {

    HomePage homePage;                                          
    SearchResultsPage searchResultsPage;

    @Step                                                       
    public void opens_etsy_home_page() {
        homePage.open();
    }

    @Step
    public void searches_for_items_containing(String keywords) {
        homePage.searchFor(keywords);
    }

    @Step
    public void should_see_items_related_to(String keywords) {
        List<String> resultTitles = searchResultsPage.getResultTitles();
        resultTitles.stream().forEach(title -> assertThat(title.contains(keywords)));
    }
}
//end:tail

В этих определениях шагов реализовано «что» за «как» шагов «задано когда». Однако, как и в любом хорошо написанном коде, определения шагов не должны быть слишком сложными и должны фокусироваться на работе на одном уровне. абстракция. Определения шагов обычно организуют вызовы к более техническим уровням, таким как веб-службы, базы данных или объекты страниц WebDriver. Например, в таких автоматизированных веб-тестах методы библиотеки шагов не вызывают непосредственно WebDriver, а скорее взаимодействуют с  Объекты страницы .

Объекты страницы содержат информацию о том, как тест взаимодействует с определенной веб-страницей. Они скрывают детали реализации WebDriver о том, как элементы на странице доступны и управляются с помощью более удобных для бизнеса методов. Подобно шагам, объекты Page являются повторно используемыми компонентами, которые облегчают понимание и обслуживание тестов.

Serenity автоматически создает экземпляры Page Objects для вас и внедряет текущий экземпляр WebDriver. Все, что вам нужно беспокоиться, это код WebDriver, который взаимодействует со страницей. И Serenity предлагает несколько быстрых клавиш, чтобы сделать это проще. Например, вот объект страницы для домашней страницы:

@DefaultUrl("http://www.etsy.com")                      
public class HomePage extends PageObject {              

    @FindBy(css = "button[value='Search']")
    WebElement searchButton;

    public void searchFor(String keywords) {
        $("#search-query").sendKeys(keywords);          
        searchButton.click();                           
    }
}

И вот второй объект страницы, который мы используем:

public class SearchResultsPage extends PageObject {

    @FindBy(css=".listing-card")
    List<WebElement> listingCards;

    public List<String> getResultTitles() {
        return listingCards.stream()
                .map(element -> element.getText())
                .collect(Collectors.toList());
    }
}
// end:tail[]

В обоих случаях мы скрываем реализацию WebDriver от способа доступа к элементам страницы внутри методов объекта страницы. Это делает код более легким для чтения и уменьшает количество мест, которые необходимо изменить, если страница изменена.