Test Data Supplier - TestNG Dataprovider на стероидах
Привет, друзья! Сегодня хочу поделиться рецептом, который поможет сделать тесты еще лучше.
На большинстве своих проектов я сейчас использую связку инструментов Java/Kotlin + TestNG
Allure + Gradle. Ранее я уже писал о некоторых подходах, которые позволяют нам более
удобно готовить данные для тестов,
работать с базой данных и писать меньше аннотаций для Allure.
В этой заметке хочу рассказать о том, как улучшить Dataprovider. Очень часто в тестах приходится оперировать различными наборами данных. В каких-то случаях данные проще захардкодить, в каких-то - тащить из внешних источников. В большинстве случаев для оптимизации кода и параметризации я использую TestNG Dataprovider.
Давайте возьмем для примера простой тест - логин форма с тремя полями и валидацией.
@Test(dataProvider = "Authentication")
public void errorMessageOnLoginWithBadCredentials(String email, String password, String errMsg) {
User badUser = new User(email, password);
at(LoginPage.class)
.loginAs(badUser)
.errorMessage
.shouldHave(exactText(errMsg));
}
@DataProvider(name = "Authentication")
public static Object[][] credentials() {
return new Object[][]{
{" ", " ", "Username is required"},
{"admin@gmail.com", "UserTest@123", "Login and / or password do not match"},
{"admin@gmail.com", " ", "Password is required"},
{"ololo@ololo.com", "admin", "Login and / or password do not match"}
};
}Очень простой сценарий: в разных случаях пользователю будут показываться разные сообщения об ошибке. Здесь я применил Dataprovider, так как для каждой итерации у нас меняются лишь входные данные для теста.
Вроде как все отлично и даже работает.
Есть ли что-то, что можно улучшить? (люблю этот вопрос на собеседовании =))
Конечно, стоит посмотреть на уродливый дата провайдер. Вот этот Object[][] - то прям боль. Учитывая то, что мы живем в 2018 году, пишем на Java 8, которая поддерживает Stream API и имеет хороший Collection API. Двухмерный массив объектов - это несерьезно!
И даже с помощью няшного Котлина нельзя особо улучшить ситуацию.
@DataProvider
fun data(): Array<Array<String>> {
return arrayOf(
arrayOf(" ", " ", "Username is required"),
arrayOf("admin@gmail.com", "UserTest@123", "Login and / or password do not match"),
arrayOf("admin@gmail.com", " ", "Password is required")
)
}Остается смириться и писать такой вот говнокод. Но на самом деле ситуацию можно поправить с помощью библиотеки Test Data Supplier. Ее автором является один мой друг - Сергей Король.
Я о ней знал давно, но как-то попробовав ее еще на начальных этапах, не особо проникся идеей. Пока на днях не решил внедрить ее в один из новых проектов.
Подключение выполняется достаточно просто. Однако там есть один нюанс: для корректной работы требуется подключение DataProviderTransformer лисенер. Так вот подключать этот лисенер стоит либо через Gradle, либо через TestNG xml. Подключение через аннотацию @Listeners не даст желаемого результата. Учтите этот момент, я уже этот путь прострадал за вас=)
После подлючения вам станут доступны все плюшки этой библиотеки.
Можно легко переписать ваши унылые дейтапровайдеры на новый лад:
@DataSupplier
fun data(): Array<Array<String>> {
return mapOf(
User(" ", " ") to "Username is required"),
User("admin@gmail.com", "UserTest@123") to "Login and / or password do not match"),
User("admin@gmail.com", " ") to "Password is required"
)
}Тест в таком случае трансформируется в такую штуку:
@Test(dataProvider = "data")
fun errorMessageOnLoginWithBadCredentials(User user, String errMsg) {
at(::LoginPage)
.loginAs(user)
.errorMessage
.shouldHave(exactText(errMsg));
}Все становится прям огненно круто. Есть, правда, один досадный момент: для полной поддержки нужно установить Idea плагин - test-data-supplier-plugin. Сама библиотека поддерживает разные навороты, о которых можно почитать в документации.
В общем всем рекомендую как минимум посмотреть на эту библиотеку, как максимум - прикрутить ее к себе в проект и пробовать.
Спасибо, что читали. Надеюсь, многим эта заметка поможет вывести тесты на новый уровень.