Автоматизация тест-кейса Яндекс Маркета

Автоматизация тест-кейса на связке Maven, Selenium, JUnit5, Allure. Документация на русском языке - согласно требованиям.

Содержание

• Build
  • Запуск тестов
  • Сгенерировать отчет
• Allure отчет
  • Запуск тестов и деплой отчета в CI
  • Запуск тестов и деплой отчета руками
• Требования
  • Тест кейс
  • Стек
  • Прочее
• Особенности реализации

Build

В окружении должна быть установлена (и прописана в PATH) java не ниже 11 версии и добавлена переменная среды JAVA_HOME.

Запуск:

./mvnw verify -DuseBrowserProfile=false

Сгенерировать отчет:

• Если в окружении Allure не установлен:

  ./mvnw allure:install
  ./mvnw allure:serve
  

• Если в окружении Allure установлен (2.24.0 и выше):

  cd ./target
  allure serve
  

Allure отчет

Запуск тестов и деплой отчета джобой (GitHub Actions)

При запуске в CI бороться с капчами сложнее, поэтому результат оставляет желать лучшего. Тем не менее посмотреть отчет можно по этой ссылке, причем относительный интерес в нем, по понятным причинам, представляет собой только этот удачливый тест:

---

---

Как ни странно, могло быть и хуже (подробнее см. в заметке Удаленное противо-captcha-стояние).

Запуск локально и деплой отчета руками

Здесь руки не так связаны, поэтому результат соответствующий:

---

---

Требования

Тест кейс

1. Открыть браузер и развернуть на весь экран.
2. Зайти на https://ya.ru/
3. Нажать на строку поиска -> Кликнуть по Маркет
4. Перейти в Каталог -> Навести курсор на раздел Электроника
5. Выбрать раздел Смартфоны
6. Задать параметр «Производитель» Apple.
7. Дождаться результатов поиска.
8. Убедиться, что в выборку попали только iPhone. Если страниц несколько – проверить все.

Тест должен работать для любого производителя из списка:

• ASUS
• Black Shark
• OnePlus
• Google
• Seals

Стек

Java, Junit Jupiter, Selenide, PageObject по стилю Selenide

Прочее

• Тест разбит на шаги. Коллега без знаний программирования по аллюр отчету должен понимать что делает тест, какие проверки происходят
• Тест должен быть параметризован
• Необходимо использовать константы через проперти файл
• Все ассерты должны быть переопределены
• Если в коде используются циклы, необходимо исключить возможность бесконечного цикла
• Обязательно использовать Джава док для всех методов и переменных. На русском языке
• Недопустимо использования Thread.sleep и Трай\кетчи. За исключением, создания собственных ожиданий (к примеру каждый 5 миллисекунд проверяем что что-то случилось, и так не более 10 секунд.). Лучше обойтись явными\неявными ожиданиями
• Помните про универсальные методы. Старайтесь писать код, полезный в других тестах, полезный коллегам. Не будьте эгоистами!
• XPath не должен содержать индексов, динамических элементов

Особенности реализации

Раздел обновляется, а не переписывается, чтобы видеть прогресс.

• Судя по тест-кейсу при выставлении, например, производителя Apple наименования, содержащие подстроку "IPhone", но не содержащие подстроку "Apple", являются корректными. Автоматизированный тест не всегда соблюдает это условие - в демонстрационных целях (чтобы было видно, что тест действительно выполняет проверку, а не просто рисует отчет с зелеными галочками).
• На каждой странице пагинации по товарам можно выполнять сколько угодно проверок, если добавить их в marketCheckAllPages(). "Падение" какой-либо из проверок не прерывает тест (использованы soft asserts).
  Update. Эта ужасная функция удалена. Вместо нее использован PageableChecker, который пора бы уже вынести в отдельный подпроект и отдельно протестировать.
• Даже если среди проверок не осталось "не упавших", тест не прерывается. Проверяются все чеки на всех страницах.
  Update. Чтобы использовать дефолтный "lazy" режим, достаточно убрать из теста .beLazy(false). В таком случае страницы проверяются пока остается хотя бы один незафейленный чек. При этом зафейленные чеки на последующих страницах не проверяются.
• При наличии на странице нескольких товаров некорректных с точки зрения конкретного чека, отчет не говорит сколько этих товаров, не выводит их список, а сообщает о первом попавшемся.
  Update. Теперь и количество сообщает. Кроме того если "плохих" элементов больше одного, помимо скриншота и веб-страницы в аттачментах появляется файл, в котором перечислены они все.
  Update2. Все элементы-причины фейла всегда указываются в логах ошибки.
• К сожалению упавшие софт-ассерты плохо отображаются в отчете: галочки/стрелочки не меняют цвет с зеленого на красный. Пришлось тернарным оператором передавать разные сообщения для успешного и неуспешного выполнения таких ассертов (для последнего случая что-то бросающееся в глаза типа “<<< FAIL >>> Имя товара не соотв…”).
  Update. Allure действительно официально не поддерживает soft asserts, но благодаря классу AllureLifeCycle в PageableChecker с этим справиться удалось.