Selenide

Вышла Selenide 6.13.0

2023-04-01T00:00:00+00:00

Всем привет!

Ура, сегодня у нас новый релиз Selenide 6.13.0

Поддержка баннеров
Новости

Поддержка баннеров

Проблема

Очень часто люди спрашивают: “А что делать, если посреди теста на экране может выскочить баннер или какой-то ещё неожиданный элемент?”

Ведь он может перекрыть другие элементы, закрыть важную кнопку и т.п. - и таким образом сломать тест.

Я всегда на это люто ругался и настоятельно советовал взять тестовую среду под контроль и самому из теста регулировать, когда баннеры должны появляться, а когда нет.

Алексей Виноградов сделал выступление на эту тему: Spinner-driven-development.

Стадия принятия

Но слишком уж это распространённая проблема. В конце концов, Селенид задуман для того, чтобы помогать людям решать проблемы, а не читать нотации.

Мы решили пойти людям навстречу и создать решение для проблемы баннеров. Теперь в начале теста вы можете вызвать метод Selenide.onBanner():

onBanner("#pizzaAds", CLOSE, ".btn-close");

Как это работает

По умолчанию, этот метод добавит вебдрайверу листенер, который будет перед каждым кликом или проверкой проверять, не появился ли элемент с данным селектором "#pizzaAds". Если появился, селенид попытается закрыть его, нажав на кнопку закрытия ".btn-close".

Этот метод называется POLL. Он самый простой и надёжный, но и самый медленный. Ведь селенид должен будет кучу раз спрашивать у браузера, не появился ли баннер. Каждый такой запрос занимает некоторое время.

Альтернативные методы

Поэтому мы добавили ещё два альтернативных метода, которыми селенид может проверять, а не появился ли баннер. Их можно включить либо глобально настройкой:

Configuration.bannerCloseMode = POLL; // по умолчанию

// Слушает события по изменению DOM через CDP:
Configuration.bannerCloseMode = CDP; // Работает только в Chromium-браузерах

// Скармливает html текущей страницы ChatGPT и спрашивает, нет ли там баннера:
Configuration.bannerCloseMode = CHATGPT; 

Либо вы можете задать его параметром с помощью using:

onBanner(using(CDP)
  .withBannerSelector("#pizzaAds")
  .withCloseButtonSelector(".btn-close")
  .withAction(CLOSE)
);

Кастомный обработчик

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

onBanner(using(CHATGPT)
  .withBannerSelector("#pizzaAds")
  .withCloseButtonSelector(".btn-close")
  .withAction((banner, closeButton) -> {
     banner.find(".title").shouldHave(text("Ваш пароль изменён."));
     String newPassword = banner.find(".new-password").text();
     closeButton.doubleClick();
   })
);

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

Хватит примерять на себя белые пальто и ссориться из-за дурацких принципов.

Давайте объединимся против баннеров!

News

Сегодня у нас три видоса про Селенид

на русском: ChatGPT: Как скачать файл в Selenide
на английском: ChatGPT: How to download file in Selenide
Ускоряем UI Автотесты с помощью подстановки Cookies by Oleh Pendrak

Андрей Солнцев

ru.selenide.org

Вышла Selenide 6.12.4

2023-03-23T00:00:00+00:00

Привет!

А вы следили за новостями 23 марта? Молодцы!

Сегодня у нас Точка Отсчёта - релиз Selenide 6.12.4.

Костыль для Хрома
Добавили поддержку jdk-http-client
Исправили $.download(PROXY) после “using”
Исправили $.clear() при пропадании элемента
Обновили зависимости
Выпустили selenide-appium 2.7.0
Выпустили selenide-selenoid 2.3.6
Новости

Костыль для Хрома

Напоминание: если вы всё ещё роете интернет в поисках лекарства против

Invalid Status code=403 text=Forbidden

то лекарство уже было выпущено в Selenide 6.12.2.

Добавили поддержку `jdk-http-client` вместо `netty-client`

По умолчанию по-прежнему используется netty-client, но если вы хотите перейти на jdk-http-client, то можете это легко сделать:

Добавить зависимость
org.seleniumhq.selenium:selenium-http-jdk-client:$seleniumVersion
Добавить пропертю перед открытием браузера:
System.setProperty("webdriver.http.factory", "jdk-http-client");

См. issue 2215 и PR 2216.

Исправили работу прокси после метода `using`

Это почти такая же проблема, как в issue 2202, но только с прокси.

В общем, стоило вам разочек использовать метод using, как у вас сразу пропадал прокси. И дальнейшее скачивание файлов (или для чего ещё вы использовали прокси) больше не работало.

Но судя по всему, про этот супер-удобный метод using мало кто знает, потому что жалоба была всего одна. :)

Ну вот, теперь и using починили, и про него узнает больше народу. :)

См. PR 2208 и PR 2209.

Исправили `$.clear()` при пропадании элемента

Как вы знаете, в селениде есть метод $("input").clear(), который очищает поле ввода. Оказалось, что метод мог упасть в одной редкой ситуации. А именно, если в результате очистки элемент пропадает. В этот момент метод $.clear() пытался сгенерировать событие on change на этом элементе - и падал.

См. issue 2207 и PR 2221.

Обновили зависимости

#2210 Bump nettyVersion from 4.1.89.Final to 4.1.90.Final
#2218 Bump slf4jVersion from 2.0.6 to 2.0.7

Выпустили `selenide-appium:2.7.0`

Добавили скролл вверх-вниз для мобильников (#139)
Исправили функцию terminateApp (#146)
Обновились на Selenide 6.12.4 (#143)

См. release notes.

Выпустили `selenide-selenoid:2.3.6`

Обновились на Selenide 6.12.4

См. release notes.

News

Я запилил первый видос после 9-летнего перерыва :) Как скачать файл в Selenide: спросим у ChatGPT
Наконец-то у меня появился доклад про Flaky tests на английском - конференция JFokus, Стокгольм, 8.02.2023
Видос Selenide: як тестувати веб-елементи от Hillel IT School

Андрей Солнцев

ru.selenide.org

Вышла Selenide 6.12.2

2023-03-09T00:00:00+00:00

Привет!

Срочно обновляйтесь на Selenide 6.12.2.

Он содержит один важный костыль для баги в Chromedriver 111.

Invalid Status code=403 text=Forbidden

В чём проблема?

Недавно вышла новая версия Chrome и Chromedriver 111. И у всех, кто на неё обновился, резко посыпались тесты. Браузер открывался, но при этом тест получал от вебдрайвера ошибку и дальше не мог ничего сделать, в том числе закрыть этот самый браузер.

В логах было видно такое вот красноречивое сообщение:

Starting ChromeDriver 111.0.5563.64 on port 31021
org.openqa.selenium.remote.http.WebSocket$Listener onError
WARNING: Invalid Status code=403 text=Forbidden
java.io.IOException: Invalid Status code=403 text=Forbidden
...

И хотя это бага хромдрайвера, для неё нашёлся один простой костыль, и мы его по-быстрому запилили в Селениде.

См. issue 2192 и PR 2194.

А вообще, обновляйтесь на HttpClient. Он требует Java11+, но зато таких багов там не будет.

Андрей Солнцев

ru.selenide.org

Вышла Selenide 6.12.0

2023-02-24T00:00:00+00:00

Привет!

В этот трагичный и одновременно праздничный день мы выпустили релиз Selenide 6.12.0.

В нём почти нет фич, но есть новый режим, который может сильно повлиять на ваши тесты.

Новый безбашенный режим

В Chromium-браузерах появился новый безголовый (headless) режим. Подробнее о нём в их блоге.

Если вкратце, этот новый режим внутри использует тот же код, что и обычный headful, и поэтому должен вылечить все болячки headless режима. А вот старый headless режим по сути был отдельным браузером со своими особенностями и багами.

В теории вы всё ещё можете переключаться между старым и новым headless режимом. Но на практике вам придётся переключиться на новый, т.к. при обновлении Chrome и Edge перестало работать скачивание файлов в старом headless режиме.

В общем, в Selenide 6.12.0 новый headless режим будет включаться по умолчанию.

См. issue 2104. Спасибо Boris Osipov за PR 2105 и PR 2169.

Улучшили логирование при скачивании файлов

Если скачивание файла падает (особенно методом FOLDER), иногда бывает сложно понять, почему именно. Мы немного доработали логирование внутри метода $.download(), так что теперь должно стать полегче.

См. PR 2167.

Улучшили скачивание файлов в Edge под Windows

До сих пор селенид отслеживал только временные файлы “.crdownload”, которые хромиум использует при скачивании файлов. Но оказалось, что на Windows браузер Edge создаёт ещё и временные файлы “.tmp”. Теперь селенид отслеживает и их.

См. PR 2167.

Обновили зависимости

bump Selenium from 4.8.0 to 4.8.1, см. PR 2161 и ченджлог Selenium.
Bump nettyVersion from 4.1.87.Final to 4.1.89.Final, см. PR 2158.

Переименовали ветку `master` в `main`

Да-да, это отголоски того самого BLM. Один умный человек убедил меня, что стоит это сделать. :)

News

Пост Test automation framework for UI testing with java by Oleksandr Podoliako
Пост Running test automation with Selenide on GitLab by Pradap Pandiyan
Моё видео с Continuous Testing Meetup: Selenide UI tests in java, 23.01.2023
Видео Автотесты с нуля для начинающих Java + Selenide + TestNG + Maven на канале FullStackQA

Ну а почему же я назвал этот день праздничным? Да потому, что 24 февраля вообще-то День Независимости Эстонии. 105 лет назад эстонские войска напихали оркам в панамку и провозгласили новое независимое государство.

Если бы не те бравые ребята на бронепоезде, не было бы сейчас Селенида. :)

UPD Вышла Selenide 6.12.1

Исправили старинную багу в методе using.

См. changelog

UPD Вышла Selenide 6.12.2

По-быстрому залепили костыль для баги в Chromedriver 111:
Invalid Status code=403 text=Forbidden

См. changelog

UPD Вышла Selenide 6.12.3

Исправили одну старую багу в методе $.download(FOLDER), если его вызвать после using.

См. changelog

Андрей Солнцев

ru.selenide.org

Вышла Selenide 6.11.1

2023-01-20T00:00:00+00:00

Хаюшки!

Одна моя знакомая из Италии рассказала, что вышел новый релиз Selenide 6.11.1.

Обрезаем только сообщения `WebDriverException`

В довольно редких ситуациях - если вы

используете кастомное действие (custom command),
и из него кидаете какую-то свою ошибку (assertion error),
и текст этой ошибки содержит несколько строк,

то Селенид обрезает этот текст, оставляя лишь первую строку. Изначально планировалось обрезать только текст WebDriverException, потому что он объективно содержит многострочный мусор:

The element could not be found (WARNING: The server did not provide any stacktrace information) Command duration or timeout: 21 milliseconds For documentation on this error … Build info: version: ‘2.29.1’, … System info: os.name: ‘Linux’, … Session ID: 610138404f5c18… Driver info: org.openqa.selenium.chrome.ChromeDriver

Но как-то так вышло, что селенид обрезал текст не только WebDriverException, а вообще всех ошибок. Теперь подправили, и свой многострочный текст вы увидите целиком.

См. PR 2131.

Чутка подправили `$.download(FOLDER)`

Это очень редко случай, так что вы наверняка этого не замечали.

Но наши тесты изредка моргали, и я покопал-покопал, да и раскопал парочку редких багов в методе $.download(FOLDER). Иногда он мог кинуть ошибку, что файл не скачался (хоть он на самом деле скачался), в двух случаях:

#2116 Если время изменения оказалось в предыдущей секунде от начала скачивания
(такое бывает, т.к. разные файловые системы выдают время изменения файла с погрешностью до секунды, и иногда оно может даже оказаться в прошлом)
#2119 Если ОС вернула время последнего изменения файла “0”
(оказываете, и такое бывает - если файловая система почему-то решила, что имя файла некорректное)

Теперь должно качаться как намасленное.

Обновили зависимости

bump WebdriverManager from 5.3.1 to 5.3.2
bump Netty from 4.1.86.Final to 4.1.87.Final, см. PR 2126.

News

Пост от Amuthan Sakthivel Почему мы выбрали Селенид, а не Селениум
Свежая статья на хабре Как написать UI-автотесты, если не умеешь программировать?
Мой доклад в девклубе Как законтрибьютить в опенсорс, чтобы не сгореть со стыда
Мой доклад в девклубе WTF Thread Pools

Статистика

Количество ежемесячных скачиваний Селенида перевалило за 490 тыщ!

Поднажмём…

Андрей Солнцев

ru.selenide.org

Вышла Selenide 6.11.0

2023-01-03T00:00:00+00:00

С Новым Годом, друзья!

Дедушка Мороз принёс нам новый релиз Selenide 6.11.0.

Добавили методы для копирования текста

Мы добавили два новых метода:

Selenide.copy() - копирует выделенный текст в буфер обмена, и
$.paste() вставляет текст из буфера обмена в поле ввода.

open("https://best-propaganda-quotes.ru");
$("#solovjov").doubleClick(); // select the quote text
Selenide.copy();
$("[name=q]").paste();
$("[name=q]").shouldHave(text("Обсираться мелкими алмазами на берегу озера Комо"));

Известные ограничения: пока что эти методы не работают на серверных линуксах (без графического окружения). Но запуск xvfb должен помочь.

См. issue 1817.
Спасибо Evgenii Plugatar за PR 2027.

Исправили метод `Selenide.download(url)`

…для случая, когда url содержит логин/пароль (т.е. ресурс защищён BasicAuth).

Например, такой код раньше работал, но сломался после обновления Apache Http client:

File f = Selenide.download("https://admin:tiger@the-internet.herokuapp.com/basic_auth");

Оказалось, что в Apache Http client усилили валидацию URL, и часть с логином и паролем больше не разрешена (это типа небезопасная практика).

Ну а селенид теперь вырезает эту часть и посылает с запросом в заголовке Authorization.

См. issue 2037 и PR 2102.

Позволяем скачивать большие файлы через прокси

Если вы скачиваете файлы методом PROXY, то размер файла не мог превышать 64 мегабайта. Изначально это казалось разумным ограничением: зачем кому-то нужно нагружать тестовый стенд, скачивая гигантские файлы? (64 и то многовато, по умолчанию в BrowserUpProxy вообще было 2 мегабайта; мы увеличили лимит до 64 в селениде)

Но оказалось, что некоторых хотят тестировать именно скачивание больших файлов. После долгих споров мы решили просто убрать это ограничение. Вам виднее, качайте сколько хотите.

File favoriteMovie = $("#topMovie").download();
assertThat(favoriteMovie)
  .hasName("BadSanta.avi")
  .as("2 GB").hasSize(2147483648L);

P.S. Но имейте в виду, со слишком большими файлами, скорее всего, прокси всё равно не справится (либо будет скачивать слишком долго). И BrowserUpProxy по-прежнему имеет встроенное техническое ограничение в 2 гигабайта (потому, что тип данных - Integer).

Но хотя бы файлы по 200 мегабайтов вы вполне сможете скачивать.

См. issue 2082 и PR 2098.

Можно обрабатывать неожиданные алерты

По умолчанию, селенид игнорирует неожиданные алерты в браузере (точнее, запускает вебдрайвер с опцией capabilities.setCapability(UNHANDLED_PROMPT_BEHAVIOUR, ACCEPT)).

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

Если это ваш случай, теперь вы можете переопределить эту настройку:

import static org.openqa.selenium.remote.CapabilityType.UNHANDLED_PROMPT_BEHAVIOUR;
import static org.openqa.selenium.UnexpectedAlertBehaviour.ACCEPT_AND_NOTIFY;

Configuration.browserCapabilities.setCapability(UNHANDLED_PROMPT_BEHAVIOUR, ACCEPT_AND_NOTIFY);

И тогда при возникновении нежданных алертов вы узнаете, какой текст в них был:

UnhandledAlertException: unexpected alert open: {Alert text : Как жопа, рогозин?} // chrome
UnhandledAlertException: Accepted user prompt dialog: Маршрут через мост недоступен. Чот бахнуло. // firefox
UnhandledAlertException: unexpected alert open: {Alert text : Обнаружены боевые комары-убийцы}  // edge
UnhandledAlertException: : Обнаружена грязная бомба // safari

См. issue 2054 и PR 2095.

Исправили пермиссии файла скриншота

Как вы знаете, при падении теста селенид автоматически сохраняет скриншот и создаёт два файла: *.png и *.html. Так вот выяснилось, что селенид создаёт эти два файла с разными пермиссиями:

-rw------- 1 root root 300295 Dec 19 10:24 1671441847908.0.png
-rw-r--r-- 1 root root 185070 Dec 19 10:24 1671441847908.0.html

И кое-кому это помешало писать сложносочинённые CI скрипты, выполняющие команды из-под разных юзеров. Чем бы девопс не тешился… :)

В общем, теперь у обоих будет “обычные” пермиссии -rw-r--r--.

См. issue 2081 и PR 2084.

Поддержка аннотации `@As` для полей без `@FindBy`

В селениде уже давно можно задавать удобные имена элементам пэдж обжекты (т.н. “алиасы”) с помощью метода as:

class LoginPage {
  SelenideElement loginButton = $(By.xpath("/long/ugly/xpath[3]")).as("Login button");
}

Но кому-то показалось, что удобно было бы повесить имя элемента в начало строки, а то справа от длинного селектора оно визуально теряется.

В общем, теперь алиас можно задать и с помощью аннотации @As:

class LoginPage {
  @As("Login button")
  SelenideElement loginButton = $(By.xpath("/long/ugly/xpath[3]"));
}

Но естественно, аннотация сработает, только если вы инициализируете пэдж обжект с помощью метода Selenide.page() или Selenide.open()

См. issue 2087 и PR 2088.

Метод для последнего сохранённого исходника страницы

Редко когда это нужно, так что не заморачивайтесь. По сути добавили методы ScreenShotLaboratory: threadScreenshots(), contextScreenshots(), lastThreadScreenshot(), lastContextScreenshot().

Спасибо Arman Ayvazyan за PR 2065.

Теперь можно добавлять URL страницы в сообщение об ошибке

Кому-то это полезно, кому-то вредно. После долгих споров сделали эту возможность опциональной (в виде плагина).

Пусть пока побудет в статусе экспериментальной возможности. Вероятно, с форматами сообщений об ошибках мы ещё будем играться.

См. issue 980 и PR 2097.

Итоги года

Подведём итоги 2022 года? За этот год Selenide был упомянут в нескольких топах:

5 Testing Automation Tools в блоге компании Qameta Software
Top Java Libraries for Automation Testing in 2022
Top Java Frameworks to Use in 2022

И наконец,

Selenide упомянут на официальном сайте Selenium в разделе “Экосистема”.

Количество скачиваний селенида выросло аж в полтора раза:

с 302 тысяч в январе до 469 тысяч в ноябре.

И всё-таки

Это был ужасный год. Но я рад, что я смог использовать накопленный багаж в виде сайта selenide.org и его аудитории, чтобы распространять антивоенную позицию. Кажется, здесь собрались люди, которые эту позицию разделяют. Чему я тоже очень рад.

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

А прекрасная свободная страна Украина отстроится и будет цвести пуще прежнего.

И через год мы с вами увидимся в Киеве на замечательной конференции SeleniumCamp.

Героям слава!

Андрей Солнцев

ru.selenide.org

Вышла Selenide 6.10.2

2022-12-08T00:00:00+00:00

Всем привет!

У нас вышел новый мини-релиз Selenide 6.10.2.

Добавили метод `$.press()`

По сути это то же самое, что sendKeys(), только он не void. То есть его можно чейнить с другими методами:

$("#username")
  .press("x")
  .press(TAB, CONTROL, ALT, ENTER)
  .should(disappear);

Спасибо Amuthan Sakthivel за PR 2032.

Генерируем события `change` в методах `$.select*`

Как вы помните, в предыдущем релизе мы переделали работу с селектами на JavaScript. Но при этом забыли, что надо ещё и генерировать события focus, click, change. Теперь генерируем.

См. issue 2050. Спасибо Vicente Rossello Jaume за PR 2051.

UPD. Исправили ещё раз в Selenide 6.10.3.

Показываем `$.selectOption()` в отчётах по-человечески

Ещё один косячок, вылезший после предыдущего рефакторинга селектов: в отчётах выскочили нечитаемые параметры. Это всё потому, что в Java у массивов нет стандартного метода toString(), приходится изобретать велосипед.

Было:

| #blockChannel     | select option([Канал Дождь, [Ljava.lang.String;@6732726])     | PASS       | 487        |

Стало:

| #blockChannel     | select option(Канал Дождь)     | PASS       | 487        |

См. issue 2047 и PR 2052.

Показываем `localStorage` в отчётах по-человечески

Почти такая же проблема: операции с sessionStorage и localStorage выглядели в отчётах нечитабельно.

Было:

| com.codeborne.selenide.LocalStorage@138a952f    | set item(['Бут', 9125])     |
| com.codeborne.selenide.SessionStorage@549w123gg | set item(['Грайнер', 3285]) |

Стало:

| localStorage            | set item(['Бут', 9125])      |
| sessionStorage          | set item(['Грайнер', 3285])  |

См. issue 2045 и PR 2046.

Обновили зависимости

#2044 #2057 bump Selenium from 4.6.0 to 4.7.1
#2036 bump browserup-proxy-core from 2.2.5 to 2.2.6
#2058 bump httpclient5 from 5.2 to 5.2.1
bump slf4j from 2.0.4 to 2.0.5

Дочерние проекты

Также зарелизили наши дочерние проекты:

Новости

Selenide Tutorial: Replacement for Selenium? на канале Testing Mini Bytes
Test automation framework for UI testing with java от Oleksandr Podoliako

Андрей Солнцев

ru.selenide.org

Вышла Selenide 6.10.0

2022-11-21T00:00:00+00:00

Недобрый вечер!

Вышел новый релиз Selenide 6.10.0.

Улучшили алгоритм скачивания файлов

Один из алгоритмов скачивания в Selenide - это FOLDER. Чтобы скачать файл, он кликает нужную кнопку и ждёт, пока в папке “Downloads” появится нужный файл.

File еноты = $("#stolenRaccoonsReport").download(using(FOLDER));
assertThat(еноты).hasName("еноты.xls");

Проблема в том, что этот алгоритм не очень хорошо работал в Firefox, когда скачивание идёт очень медленно. Оказалось, что Firefox сразу создаёт в папке два файла: “еноты.xls” и “еноты.xls.part”, и оба пустые. И лишь затем начинает их потихоньку заполнять.

В общем, наш алгоритм стал умнее. Теперь он

Ждёт, когда в папке появятся хоть какие-нибудь подходящие файлы.
Ждёт, когда пропадут все файлы *part (в Firefox).
Ждёт, когда пропадут все файлы *crdownload (в Chrome).
Ждёт, когда все файлы замрут как минимум на секунду (в остальных браузерах).

Такой подход должен обеспечить более надёжное скачивание файлов.

См. issue 1989 и PR 2003.

Ускорили отрицательное скачивание файла

Часто люди выставляют большой таймаут на скачивание файла. Особенно если файл большой:

File video = $("#skaebova").download(using(FOLDER)
  .withTimeout(Duration.ofSeconds(99))
  .withName("пыня мобшиза.MP4"));

Но незачем ждать так долго, если скачивание даже не началось. Например, если клик тупо не попал по кнопке (как это бывает, я рассказывал в видео “Flaky tests”.

Для ускорения падения теперь можно задать второй параметр “increment timeout”:

File video = $("#skaebova").download(using(FOLDER)
  .withTimeout(ofSeconds(99))
  .withIncrementTimeout(ofSeconds(2))
  .withName("пыня мобшиза.MP4"));

В этом случае общий таймаут на скачивание 99 секунд, НО если в течение 2 секунд не было никаких изменений в папке для скачивания, то метод выкинет ошибку сразу.

См. issue 1990 и PR 2023.

Выбираем опции в `<select>` через JavaScript

Это должно сделать работу с селектами быстрее. И теперь селенид выкидывает более подробную ошибку, если <select> (или <option>) оказался disabled.

Например, для такого селекта:

<select id="region">
  <option value="belgorod">Belgorod</option>
  <option value="kherson" disabled>Kherson</option>
  <option value="zaporozhia" disabled>Zaporozhia</option>
</select>

Попытка выбрать disabled опцию:

$("#region").selectOption("Kherson");

выдаст понятную ошибку с подробным объяснением:

Invalid element state [#region/option[text:Kherson]]: Cannot select a disabled option

Раньше эта ошибка была не такой подробной:

java.lang.UnsupportedOperationException: You may not select a disabled option

(а ещё раньше такой тест вообще не падал, но и опцию не выбирал)

См. issue 1553 и PR 1876.

Отдельное спасибо Oleg Berezhnoy за PR 1553, который хоть и не попал в селенид, но инициировал целую дискуссию и в селениде, и в самом селениуме, в т.ч. о том, за что должен или не должен отвечать селениум, и что такое “просто фреймворк” и “опионейтед фреймворк”.

Сделали `$.click(options)` “чейнебл”

Люди часто жалуются, что метод $.click() имеет тип void, то есть его нельзя чейнить:

  $(".btn").click().should(disappear);

Увы, это мы исправить не можем, т.к. класс SelenideElement наследует метод void click() из селениумовского WebElement.

Но мы сделали “чейнебл” другой click метод, который с параметрами (т.н. “оверлоадед”). Теперь хотя бы его можно “чейнить”:

  $(".btn")
    .click(usingDefaultMethod())
    .should(disappear);

  $(".btn")
    .click(usingDefaultMethod().withOffset(42, 42))
    .shouldHave(cssClass("alert"));

См. issue 2007 и PR 2008.

Исправили размер окна для новых вкладок

Спасибо Boris Osipov за PR 2017.

P.S. Исправили ещё раз в Selenide 6.10.1

Поддерживаем логин/пароль BasicAuth со спецсимволами

Selenide умеет открывать сайты, защищённые паролем (т.н. BasicAuth):

open("/basic-auth/hello", BASIC, 
  new BasicAuthCredentials("", "Královec", "is Czechia /:)"));

Эти логин-пароль добавляются либо в http заголовок Authorization (если прокси включён), либо в URL (если прокси выключен).

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

https://Královec:is Czechia /:)@127.0.0.1:4405/basic-auth/hello

и браузер не мог открыть страницу.

Мне по-настоящему неловко, что я как-то не увидел этой страницы. Надеюсь, вы меня простите.

В общем, теперь такие хитрые пароли тоже должны работать. Селенид экранирует все спецсимволы и генерирует корректный URL:

https://Kr%C3%A1lovec:is+Czechia+%2F%3A%29@127.0.0.1:27663/basic-auth/hello

См. issue 2020 и PR 2021.

Обновили зависимости

Selenium from 4.5.0 to 4.6.0, см. ченджлог
WebDriverManager from 5.3.0 to 5.3.1, см. ченджлог
BrowserUpProxy from 2.2.3 to 2.2.5, см. ченджлог
Netty from 4.1.82.Final to 4.1.85.Final
LittleProxy from 2.0.13 to 2.0.14, см. ченджлог
#2014 Bump httpclient5 from 5.1.3 to 5.2, см. PR 2014
#2025 bump slf4j from 2.0.3 to 2.0.4, см. PR 2025

Дочерние проекты

Также зарелизили наши дочерние проекты:

Новости

JetBrains выпустила AQUA - новую IDE для автотестов! Клёвое лого!
В Selenium появился свой встроенный аналог WebDriverManager. Кто-то уже попробовал?
Новый фреймворк Selenide Pages на базе Selenide от Maxim Kochetkov. Клёвое лого!

Мои свежие видосы

Появилось видео моих осенних докладов из таллиннского девклуба:

Как законтрибьютить в опенсорс, чтобы не сгореть со стыда
WTF Thread Pools - как накосячить с потоками в Java (с зубодробительными примерами из Selenium)

Видосы и читосы

Видос Чтение логов из браузера через Selenide от Oleh Pendrak
Пост All About Selenide от Muhammad Naeem
Видос Working with web elements using Selenide от Automation Bro
Пост Page Object Model из серии “Selenide Tutorial Series” от Automation Bro
Пост Как кастомизировать UI артефакты для Selenide + Selenoid + Allure (with TestOPS) на Хабре

Статистика

Наша группа в LinkedIn насчитывает уже 176 участников. Присоединяйтесь!
Подъехала свежая статистика скачиваний Селенида. Перевалили за 470 тыщ!

Андрей Солнцев

ru.selenide.org

Вышла Selenide 6.9.0

2022-10-07T00:00:00+00:00

Привет!

Позвольте прервать ваш думскроллинг хорошей новостью.

Вы выпустили Selenide 6.9.0! В основном прокачали прокси и обновили селениум.

Научили прокси подменять ответ сервера

Как вы знаете, селенид умеет запускать свой встроенный прокси между браузером и тестируемым приложением. До сих пор мы использовали его в основном для отслеживания запросов (логирования, скачивания файлов), но теперь ещё и добавили возможность подменить ответ сервера. Это удобно, например, чтобы замокать ответ какого-то сервиса.

Давайте рассмотрим на каком-нибудь простеньком абстрактном примере.

Пример

Допустим, вы тестируете сайт, показывающий результаты референдума. Это html-страница по адресу, скажем, https://referendum.ru, которая обращается к сервису https://cik.ru и тянет с него json с результатами голосования.

Поскольку результаты заранее неизвестны, а сайт протестировать нужно здесь и сейчас, мы хотим проверить, как он будет выглядеть в разных пограничных случаях (corner cases).

Тест

open();
getSelenideProxy().responseMocker().mockText("cik-mock",
    urlStartsWith(GET, "https://cik.ru/api/gov/no/referendum"), 
    () -> "{votes: 2133326, for: 99.23, against: 0.77}");

open("https://referendum.ru");
$("#votesFor").shouldHave(text("99.23%"));
$("#h3").shouldHave(text("Не только порадовали, но и удивили"));

Детали

Остановимся подробнее на первом параметре cik-mock. Это имя мока. Нужно оно для того, чтобы после теста его отменить (чтобы случайно не повлиять на следующие тесты):

@AfterEach
void tearDown() {
  getSelenideProxy().responseMocker().reset("cik-mock");
}

Ну или для надёжности можно отменить все моки:

@AfterEach
void tearDown() {
  getSelenideProxy().responseMocker().resetAll();
}

Ограничения

Если страница и сервис работают на одном домене, ограничений нет. А вот если страница обращается к сервису на другом домене, то мок сработает только при выполнении условий:

страница и сервис бегают на https (не http)
сервис работает и физически доступен из прокси

В общем

Использование моков - мощная техника, позволяющая вам проверять разные пограничные условия, которые иначе повторить сложно или невозможно (“146% голосов за”, “никто не явился на выборы”, “сервис недоступен” и т.д.)

Не стесняйтесь своего желания что-то подправлять, подчищать, добавлять. Будет так, как вы захотите.

См. issue 1254 и PR 1978.

Посылаем заголовок авторизации только нужному домену

Некоторые сайты, которые вам приходится тестировать, закрыты от внешнего мира с помощью BasicAuth. Селенид позволяет их открыть с помощью метода open с доп. параметрами:

open("https://referendum.ru/admin", BASIC, 
             new BasicAuthCredentials("vlastelin", "gojda!!!"));

Этот метод умеет обходить BasicAuth:

если прокси выключен - добавлением логина-пароля в URL,
а если прокси включен - добавлением заголовка Authorization в запросы от браузера к серверу.

Но вот незадача. Недавно мы обнаружили, что селенид слал заголовок Authorization не только тестируемому приложению, но и всем сторонним сервисам, к которым оно могло обращаться (например, S3 или Google authentication).

Теперь селенид будет посылать заголовок Authorization только на нужный домен, но и вам придётся указать этот домен в конструкторе:

open("https://referendum.ru/admin", BASIC, 
             new BasicAuthCredentials("referendum.ru", "vlastelin", "gojda!!!"));

См. issue 1974 и PR 1975.

Подкрутили имя прокси хоста

Когда вы включаете прокси в селениде (например, через Configuration.proxyEnabled = true), селенид запускает встроенный прокси-сервер на случайном порту. И открывает браузер с указанием использовать прокси-сервер HOST:PORT. Вопрос, какой HOST тут использовать?

До сих пор по умолчанию использовался результат команды ClientUtil.getConnectableAddress() (это поведение по умолчанию в BrowserUpProxy). Но с этого релиза будет использоваться new NetworkUtils().getNonLoopbackAddressOfThisMachine() (это метод из Selenium). Мне лень разбираться, в чём там их специфика, но на моём компе они иногда выдают разный результат:

new NetworkUtils().getNonLoopbackAddressOfThisMachine() -> 192.168.0.18
ClientUtil.getConnectableAddress() -> 127.0.0.1

И первый однозначно лучше, когда браузер бежит на другой машине или в контейнере. Под адресом 127.0.0.1 прокси просто не будет виден с другой машины.

Кстати, если этот механизм почему-то вам не помог, вы всегда можете явно задать имя хоста для прокси через настройку Configuration.proxyHost = "my.comp.eu";

См. PR 1970.

Обновились на Selenium 4.5.0

Из заметных изменений:

удалили поддержку браузера Opera
добавили альтернативную реализацию вебдрайвера на JDK 11 HTTP client вместо Netty client
Добавили проверки на disabled в класс Select (больше не получится выбрать задизейбленный option в выпадающем списке)
Убрали имя хоста из селениумовских эксепшенов

цуко, я просил об этом ещё в 2015 году!!!

См. ченджлог и PR 1967.

Выкинули поддержку Opera

Следствие предыдущего пункта. Селениум выкинул - и мы выкинули. Тестировать в опере не имеет особого смысла, т.к. это по сути тот же Chrome. Если очень хочется - можно, просто используйте chromedriver.

См. PR 1967.

Убрали `getAlias` из отчётов

Спасибо Reserved Word за PR 1971.

Вернули настройку “connection timeout”

Это мало кому нужно, так что смело пропускайте.

Когда-то у нас было две настройки для http клиента вебдрайвера: “connection timeout” и “read timeout”. Первую пришлось убрать при обновлении на Selenium 4, потому что её там выпилили. Теперь её реанимировали в Selenium 4.5.0, ну и мы реанимировали.

См. PR 1977.

Обновили зависимости

LittleProxy from 2.0.12 to 2.0.13
slf4j from 2.0.2 to 2.0.3

Новости

Доклад Сергея Брита Selenide + Playwright Java = объединяй и властвуй - конференция SQA Days EA, 01.10.2022
Доклад Алексея Виноградова Spinner-driven-development

Айтишники, учите английский по ирландским комикам!

Андрей Солнцев

ru.selenide.org

Вышла Selenide 6.8.1

2022-09-27T00:00:00+00:00

Добре!

Ловите мини-багфикс Selenide 6.8.1.

Это касается только тех, кто напрямую вызывает в своих тестах

new RemoteWebDriver(url, options)

и словил NoClassDefFoundError после обновления на Selenide 6.8.0.

Предыстория

Что такое OpenTelemetry? Это какая-то штука, которую зачем-то добавили в Selenium 4, но людям забыли сообщить, зачем это вообще нужно и как этим пользоваться. Ну и по факту всем пофиг, никто не пользуется.

Да и в самом селениде мы её явно выпилили в PR 1763.

Зависимость OpenTelemetry в Selenium - как специальная военная операция. Никто не знает, зачем она нужна.

Проблема

В общем, у нормальных пользователей Селенида проблемы и не возникнет.

НО если вы в своих тестах явно вызываете конструктор new RemoteWebDriver(url, options), то он, к сожалению, требует зависимости OpenTelemetry. И после обновления на Selenide 6.8.0 такие пользователи начали получать NoClassDefFoundError.

Временное решение

Добавьте параметр false в конструктор: new RemoteWebDriver(url, options, false). Этот false говорит “не используй телеметрию”.

Демобилизовали зависимость OpenTelemetry

В общем, мы по-быстрому выпустили Selenide 6.8.1, в котором вернули OpenTelemetry.

См. issue 1965 и PR 1966.

Андрей Солнцев

ru.selenide.org

Вышла Selenide 6.8.0

2022-09-24T00:00:00+00:00

Недоброе утро!

Пока в мире творится здипец, мы выпускаем релиз Selenide 6.8.0.
Фич немного, больше обновление зависимостей.

Рекурсивный поиск по shadow dom

Как вы знаете, в селениде есть возможность искать элементы внутри shadow dom. И даже в нескольких вложенных shadow dom:

$(shadowCss("#reportButton", 
     "#shadow-host", "#inner-shadow-host")).click();

Хорошо, что это возможно, но это по-прежнему требует ваших временных затрат на то, чтобы изучить dom и найти точные локаторы для всех этих теневых элементов.

Теперь вы сможете сэкономить время с помощью нового метода shadowDeepCss - он ищет элемент во всех shadow root по всему dom.

$(shadowDeepCss("#reportButton")).click();

Естественно, остаётся риск, что такой “слишком широкий” поиск может найти и не тот элемент, если в ваших теневых областях есть несколько элементов в искомым локатором. В этом случае придётся вернуться к более точечному поиску.

Как и в случае с базами данных и сосисками, “внутрь лучше не заглядывать” - там начинка из мудрёного джаваскрипта для поиска по дереву.

См. issue 1946.

Спасибо

Boris Osipov за PR 1947, а также
Georgegriff за проект query-selector-shadow-dom, откуда мы этот код и спёрли.

Добавили метод `page()`, не требующий параметр `Class`

Дорогие фанаты пэдж обжектов, садитесь поудобнее, это для вас. В вашей жизни наступает переломный момент.

Теперь в метод page(Class pageObjectClass) больше не нужно передавать параметр Class. Да-да! Вместо

SelectsPage page = page(SelectsPage.class);

вы сможете писать просто

SelectsPage page = page();

Раньше я думал, что Java так не умеет, но потом нашёл хак.

См. PR 1961 и спасибо Тагиру Валееву за хак.

Добавили аннотацию `@As`

… для задания алиасов полям пэдж обжекта.

1. Без алиасов

Если у вас есть пэдж обжект с аннотациями типа @FindBy:

class PageObject {
  @FindBy(xpath="//table/div[3]/span[4]/h1")
  SelenideElement header;
}

И тест типа page.header.shouldBe(visible),

То в отчётах он выглядит громоздко и непонятно:

| open                                  | https://devclub.eu  | PASS  |
| By.xpath: //table/div[3]/span[4]/h1   | should be(visible)  | FAIL  |

А если тест упадёт, то в сообщении не очень-то понятно, о каком элементе идёт речь:

Element not found {By.xpath: //table/div[3]/span[4]/h1}

Люди часто хотят дать какое-то человеческое название этому элементу, чтобы не видеть в отчётах длинный непонятный xpath.

2. Сопротивление

Я всегда был против этого. Я считаю, что не только отчёты, но и сами тесты должны быть читабельными. Я за чистый код. Не нравится уродливый xpath - ну так измени его, а не прячь!

Но потом я решил дать заднюю.

Ведь если мы не дадим заднюю, то они могут дать заднюю, а вот если мы её дадим, они её не дадут. Заднюю никто не даст больше, кроме нас.

Убедительно же! Поэтому в версии Selenide 5.17.0 мы добавили метод $.as("alias").

3. С алиасами

А с этого релиза - ещё и можете навесить аннотацию @As на поля поля пэджобжектов.

class PageObject {
  @As("Large header")
  @FindBy(tagName = "h1")
  SelenideElement header1;
}

В отчётах он будет выглядеть короче:

| open    | https://devclub.eu   | PASS   |
| title   | should be(visible)   | FAIL   |

А при падении теста будет легче понять, о каком элементе речь:

Element "title" not found {By.xpath: //table/div[3]/span[4]/h1}

См. issue 1903 и PR 1956.

Не забывайте: врут все.

Документация врёт, комментарии врут, пользователи врут. Рано или поздно соврёт и алиас. Локаторы поменяли, а алиас забыли. Или элемент скопировали, а алиас забыли поменять. И т.д.

Отчёты - это хорошо, но в конечном итоге верить можно только коду.

Обновили зависимости

BrowserUpProxy from 2.2.2 to 2.2.3
LittleProxy from 2.0.11 to 2.0.12
Netty from 4.1.80.Final to 4.1.82.Final
slf4j from 2.0.0 to 2.0.2
JUnit from 5.9.0 to 5.9.1 – см. release notes

Объявлена частичная мобилизация зависимостей!

Новости

Продолжается серия от Dilpreet Johal - теперь Upload file with Selenide
Alchemy or Translating JIRA with Selenide от Tomasz Buga
Вышла Java 19.

Статистика

Свежая статистика скачиваний Селенида нас только радует. Перевалили за 400 тыщ!

Смотрите Масяню!

Андрей Солнцев

ru.selenide.org

Вышла Selenide 6.7.4

2022-09-05T00:00:00+00:00

Привет!

Я календарь перевернул, и снова релиз Selenide 6.7.4.

Добавили настройку `remoteReadTimeout`

Ещё недавно я жаловался на то, что в селениде и так слишком много настроек, но нам не оставили выбора.

В общем, мы добавили ещё одну настройку Configuration.remoteReadTimeout (также известную как -Dselenide.remoteReadTimeout).

Она пригодится тем, кто запускает браузер удалённо, но при этом браузеров на сервере не хватает, и приходится ждать в очереди. И поэтому дефалтового таймаута в 1.5 минуты оказывается недостаточно, чтобы элементарно открыть браузер.

Лично я называю это адом на проекте, но кто мы такие, чтобы мешать людям добровольно жариться на сковородке…

В общем, теперь вы можете указать какой угодно таймаут в билд-скриптах, в командой строке и т.п.

Спасибо Rodion Goritskov за PR 1936.

Исправили мини-косяк в “Dead threads watchdog”

Вы видели когда-нибудь java.lang.IllegalStateException: Shutdown in progress в логах?

Значит, не обновились на Selenide 6.7.2 :)

В общем, обновляйтесь сразу на 6.7.4 - и всё будет заерысь.

См. issue 1942 и PR 1943.

Обновили зависимости

PR 1932 Bump Netty from 4.1.79 to 4.1.80

Новости

Андрей Солнцев

ru.selenide.org

Вышла Selenide 6.7.3

2022-08-27T00:00:00+00:00

Привет!

Вы читаете пресс-релиз Selenide 6.7.3 в пиратском переводе.

А что делать, все хотят кушать…

Добавили условие `partialValue`

По аналогии с $.shouldHave(partialText("Добрый ко")) теперь появилась и $.shouldHave(partialValue("cola")).

Это если вы установили настройку Configuration.textCheck = FULL_TEXT, но хотите проверить значение какого-то инпута или textarea частично, а не полностью.

См. issue 1923 и PR 1924.

Добавили условие `tagName`

Наверное, оно нечасто нужно, т.к. мы часто ищем элемент по тэгу, и уж потом проверяем другие атрибуты. Да и вообще, тэг - это внутренности, которые пользователь не видит, поэтому, может, и проверять его не нужно.

Тем не менее, теперь вы можете проверять тэг:

$(".btn-primary").shouldHave(tagName("button"));

Или фильтровать коллекцию по тэгу:

$$(byText("Submit!")).filterBy(tagName("button"));

См. issue 1928 и PR 1929.

Проверяем, что элемент - `<select>`

… в методах $.getSelectedText() и getSelectedValue().

Изначальная задумка этих методов была в том, чтобы найти выбранную опцию в селекте, и вернуть её текст или значение.

Но

во-первых, из названия это неочевидно (и поэтому мы переименовали их в $.getSelectedOptionText() и getSelectedOptionValue())
а во-вторых, эти методы можно было вызвать на любом другом элементе и получить непредсказуемое поведение.

Теперь попытка вызова $("div").getSelectedOptionText() выкинет IllegalArgumentException.

См. PR 1934.

Обновили зависимости

PR 1932 Bump webdrivermanager from 5.2.3 to 5.3.0
PR 1931 Bump slf4jVersion from 1.7.36 to 2.0.0
PR 1921 Bump browserup-proxy-core from 2.2.1 to 2.2.2

Новости

Selenide puzzler Логическое И или ИЛИ?
Selenide упомянут в Top Java Frameworks to Use in 2022

И наконец, невиданное!

Selenide упомянут на официальном сайте Selenium в разделе “Экосистема”.

Не может быть!

Не прошло и 10 лет!

А нет, прошло…

Андрей Солнцев

ru.selenide.org

Selenide puzzler

2022-08-22T00:00:00+00:00

Привет!

Вы любите пазлеры? Соскучались по пазлерам? В последний раз мы показывали пазлеры аж в 2017 году, кто не смотрел - смотрим!

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

Одинаково ли работают эти строки? Или есть какая-то разница?

1. $(".btn").shouldBe(visible, enabled);
2. $(".btn").shouldBe(visible).shouldBe(enabled);

Варианты ответов

Люди в твиттере и чатиках накидали разных вариантов:

обе строчки работают одинаково (самый популярный ответ)
первый случай: логическое or, второй: логический and
Второй работает на %ожидание по умолчанию% дольше.
Первый должен отработать с одним тайм-аутом, второй должен с двумя тайм-аутами
в первом случае упадёт, если отсутствует любое из условий, во втором - если не visible, но enabled.

Правильный ответ

В большинстве случаев оба варианта работают одинаково.

Оба варианта - это логическое AND. В обоих вариантах селенид проверит, что элемент соответствует обоим условиям.

	enabled	disabled
видимый	ok	nok
невидимый	nok	nok

Но есть нюанс.

Нюанс

Разница проявится в том случае, если элемент соответствует условиям не сразу, а через какое-то время. Причём первому условию меньше, чем за 4 секунды, а второму - больше. (Допустим, visible он становится через 3.5 секунды, а enabled - ещё через 3.5 секунды).

Всё дело в том, что таймаут (по умолчанию 4 секунды) есть у метода shouldHave, а у проверок (visible, enabled, cssClass, text) никакого таймаута нет - они просто умеют проверить, да или нет.

Пример

Откроем для примера Светофор. Светофор становится зелёным через 3.5 секунды, а текст на нём появляется ещё через 3.5 секунды.

Первый вариант проверяет, что светофор удовлетворит обоим условиям в течение 4 секунд:

  $("#light").shouldHave(cssClass("green"), text("GO!")); // таймаут 4 секунды

И эта проверка упадёт, т.к. таймаут на эту проверку - 4 секунды, но элемент не приобретёт и цвет, и текст в течение 4 секунд.

А второй вариант не упадёт:

$("#light")
  .shouldHave(cssClass("green")) // таймаут 4 секунды
  .shouldHave(text("GO!")); // и плюс ещё 4 секунды

Первая проверка дождётся, пока элемент станет зелёным (и он станет в течение 4 секунд). После этого запустится вторая проверка и запустит новый таймаут с целью дождаться, пока у элемента появится текст. И он дождётся.

Видимо, наиболее близкий к правильному был ответ “Первый должен отработать с одним тайм-аутом, второй должен с двумя тайм-аутами”.

Ваши пазлеры

Есть ли у вас свои пазлеры? Присылайте их нам, давайте будем отгадывать вместе!

Андрей Солнцев

ru.selenide.org

Вышла Selenide 6.7.2

2022-08-14T00:00:00+00:00

Привет!

Мы выпустили мини-релиз Selenide 6.7.2 с исправлением утечек памяти.

Да-да, мы серьёзные ребята, у нас тоже бывают утечки.

Но не пугайтесь, они некритические. Вряд ли кто-то из вас их вообще замечал.

Исправили утечки с shutdown hooks в Selenide

Если в тесте много-много раз открывать и закрывать вебдрайвер

for (int i = 0; i < 1000; i++) {
  open("about:blank");
  closeWebDriver();
}

то расход памяти потихоньку растёт:

Красная линия, ты где?

А вот что случилось на самом деле.

Это просто сдетонировало несколько shutdown хуков, которые селенид складировал для каждого открытого вебдрайвера.

См. issue 1917 и PR 1919.

После обновления на версию 6.7.2 память больше не растёт:

Обновляемся на Selenide 6.7.2, выдыхаем и идём на пляж.

Исправили утечку в LittleProxy

Мы обновились на версию LittleProxy 2.0.11, в которой была исправлена ещё одна утечка памяти.

См. PR 1918 и PR 141

Обновились на Selenium 4.4.0

в котором даже есть одно лично моё исправление, так-то! Которое, кстати, помогло нам исправить и следующую проблему.

См. PR 1913 и Selenium changelog

Исправили плагин `full-size-screenshot`

В нашем новом плагине full-size-screenshot была одна известная проблема (на самом деле вызванная багой в селениуме): если вы запускаете браузер удалённо и открываете несколько вкладок или окон, то селенид мог взять скриншот не с того окна.

Эта ошибка была исправлена в Selenium 4.4.0, и соответственно, у нас она теперь тоже исправится.

См. PR 1920 и PR 10811.

Ссылки

Статья Working Efficiently with Selenide by Zainab Firdos, 22.06.2022
Серия руководств Selenide Tutorial Series by Dilpreet Johal, 13.06.2022
Видео-руководство Selenide Java Tutorial Series by Automation Bro, 13.06.2022
Статья How to Start Your Friendship with Selenide by Miki Szeles, 30.03.2022
Оффтопик: моё выступление на типа открытом микрофоне про поездки на конференции в Киев - “Твой выход”, 23.07.2022, Таллинн

Андрей Солнцев

ru.selenide.org

Вышла Selenide 6.7.0

2022-08-04T00:00:00+00:00

Привет!

У нас случился толстенький релиз Selenide 6.7.0

Теперь `$.shouldHave(text)` может проверять текст целиком

Испокон веков команда $.shouldHave(text) проверяла не текст целиком, а только подстроку:

  <div id="freedom-to">Britney Spears</div>

  $("#freedom-to").shouldHave(text("Brit"));  // was OK

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

Но похоже, это всё-таки была неудачная идея, т.к. новички по умолчанию предполагают, что текст проверяется целиком, и выхватывают свою порцию WTF, когда обнаруживают, что все их проверки проверяли немного не то. :)

А левые символы селенид научился правильно игнорировать (например, несколько пробелов/табов/переводов подряд эквивалентны одному пробелу).

NB! Поскольку это изменение слишком уж кардинальное и наверняка сломает кучу ваших тестов, мы пока оставили по умолчанию старое поведение. А новое можно включить такой настройкой:

  Configuration.textCheck = FULL_TEXT;

А когда вам нужно проверить именно подстроку, можете использовать новую проверку partialText:

  $("#freedom-to").shouldHave(partialText("ey Spear"))

Возможно, мы включим этот режим по умолчанию в следующей мажорной версии Selenide 7.0.0 - а до тех пор вы можете поиграться и дать нам обратную связь.

См. issue 1780 и PR 1783.

Научили Селенид делать большие скриншоты

Ну наконец-то!

Как вы знаете, при падении теста селенид автоматически делает снимок экрана (скриншот), чтобы помочь вам понять, почему тест упал. По умолчанию вебдрайвер умеет снимать не всё окно браузера, а только видимую его часть. А самое важно часто оказывается за пределами экрана - тест валит какая-нибудь неактивная кнопка внизу экрана или всплывшее уведомление где-нибудь в углу.

Теперь вы можете одной строчкой подключить плагин, который снимает скриншот с полным содержимым веб-странички:

testImplementation "com.codeborne:selenide-full-screenshot:6.7.0"

P.S. Фича работает только для браузеров, поддерживающих CDP (Chrome, Edge и т.д.) и Firefox. Для остальных будут по-прежнему обычные скриншоты.

См. issue 1799 и PR 1858. Спасибо Aliaksandr Rasolka за PR 1800.

Добавили кэширование элементов в пэдж обжектах

Как вы знаете, селенид поддерживает обычные селениумовские пэдж-обжекты с аннотациями @FindBy. Но вот аннотацию @CacheLookup селенид до сих пор не поддерживал - нам это казалось ненужной оптимизацией, ведь в тестах большая часть времени теряется вовсе не на поиск элементов.

Но теперь вот поддерживаем, почему бы нет. Вдруг у кого-то всё настолько оптимизировано, что именно поиск элементов стал узким горлышком. Хотел бы я посмотреть на такой проект. :)

Спасибо Ilya Koshaleu за PR 1894.

P.S. Встаёт вопрос, а не надо ли добавить кэширование и для обычных $ и $$. А как это оформить - параметром, настройкой? Новым методом?

Предлагайте ваши идеи!

Отменили аннотацию `@Report`

Вот культура отмены добралась и до аннотаций!

Это изменение касается любителей TestNG, которые использовали селенидовский отчёт. Для этого им надо было повесить на тесты две аннотации:

  @Listeners({TextReport.class})
  @Report
  class MyTest {...}

Почему так сделали - это долгая история про корявые принципы работы листенеров в TestNG (вкратце: добавление аннотации листенера одному классу внезапно влияет на все остальные классы). Но теперь мы поняли, что систему можно упростить: аннотация @Report больше не нужна.

А отчёт будет генерироваться для всех тестов, помеченных аннотацией @Listeners({TextReport.class} и их потомков.

См. issue 1891 и PR 1909.

Декодируем имя скачанного файла

Оказалось, что при скачивании файла имя файла в ответе сервера иногда бывает закодировано в Base64. А селенид считывал имя файла как есть. Теперь вот умеет расшифровывать и Base64.

См. issue 1886 и PR 1889.

Починили `$.setValue()` в IE

Оказалось, мы недавно сломали метод $.setValue() в Internet Explorer. Не то чтобы случайно: IE ведь официально отдал концы. Но жалобы были, и мы его вернули.

См. PR 1907.

Сделали публичным `HttpClientTimeouts`

Но лишний раз туда лучше не лазать.

См. PR 1902.

Вернули тип параметра `String` для `$.setValue()`

Лично у меня подгорает от того, что такая проблема вообще возникла.

Подробности в issue 1885 и PR 1888.

Добавили валидацию расширения файла

См. PR 1887.

Обновили зависимости

UPD Selenide 6.7.1

вернули параметр Driver в метод SelenidePageFactory.findSelector() - он используется в selenide-appium.

Новости

Opinionated reporting framework for Selenide от Ulrich Mayring
Новая версия Пацан накодил - пацан протестил - Career Day, Минск, 04.06.2022
Extending open-source libraries: Selenide & Selenium - Selenium Conf, 30.07.2022
Автоматизація з Selenide, ввідне заняття by Роман Маринский
Flaky Tests - devclub.ee, Tallinn, 05.07.2022
Оффтопик: моё выступление на типа открытом микрофоне про поездки на конференции в Киев - “Твой выход”, 23.07.2022, Таллинн

Андрей Солнцев

ru.selenide.org

Вышла Selenide 6.6.6

2022-07-01T00:00:00+00:00

Добър вечер!

У нас вышел ещё один мини-релиз Selenide 6.6.6

Удалили старые капабилити

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

Теперь селенид их больше не проставляет: acceptSslCerts, handlesAlerts, javascriptEnabled, takesScreenshot. Мы не забудем вас, друзья! Вы служили нам верой и правдой больше 10 лет.

См. issue 1862, issue 1866 и PR 1870.

Исправили ClearWithShortcut

… при работе с вебдрайвером, завёрнутым в листенеры. Редкая ситуация, не заморачивайтесь.

Спасибо Petro Ovcharenko за PR 1856.

Добавили короткие варианты для вызова `$.click`

Раньше, чтобы кликнуть со сдвигом или с кастомным таймаутом, приходилось писать довольно длинную строку:

$.click(withDefaultMethod().offset(123, 222));
$.click(withDefaultMethod().timeout(...));

Теперь же можно написать короче:

$.click(withOffset(123, 222));
$.click(withTimeout(...));

См. PR 1875.

Добавили поддержку мобилок при проверке, жив ли вебдрайвер

Мелкое исправление для selenide-appium. Чтобы проверить, а жив ли браузер, селенид периодически дёргает метод WebDriver.getTitle() (если вы переиспользуете один вебдрайвер между разными тестами).

А тут обнаружилось, что метод getTitle() не поддерживается в Appium. Пришлось учесть.

См. issue 1878 и PR 1879.

Исправили логику настройки `reopenBrowserOnFail`

Ещё одно исправление для улучшения поддержки мобилок.

См. issue 1880 и PR 1881.

Обновили зависимости

WebDriverManager с 5.2.0 на 5.2.1.
byteBuddyVersion с 1.12.11 на 1.12.12.

Выпустили selenide-appium 2.1.0

Немного улучшили там поддержку тестов на iOS.

См. selenide-appium.

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

Теперь слово за автоматизаторами.

Андрей Солнцев

ru.selenide.org

Вышла Selenide 6.6.4

2022-06-20T00:00:00+00:00

Приветос!

У нас вышел ещё один мини-релиз Selenide 6.6.4.

Добавили условие `exactTextsCaseSensitive` для коллекций

В селениде есть несколько проверок для текстов коллекций:

$$("li").shouldHave(texts("foo", "bar", "baz"));
$$("li").shouldHave(textsInAnyOrder("foo", "bar", "baz"));
$$("li").shouldHave(exactTexts("foo", "bar", "baz"));
// и др.

Теперь к ним добавилась ещё одна:

$$("li").shouldHave(exactTextsCaseSensitive("foo", "bar", "baz"));

Спасибо Ben Heap за PR 1861.

Сделали метод `$.getSelectedOption()` ленивым

По задумке, (почти) все методы Селенида должны быть ленивыми.

Например, просто вызов $("#nope") не должен падать, если элемента нет. Это позволяет писать отрицательные условия:

$("#nope").shouldNot(exist);

Оказалось, что метод $("select").getSelectedOption() не был ленивым и падал сразу, если селект ещё не успел подгрузиться и т.д.
То есть вы в принципе не могли написать такую проверку:

  var option = $("select#gender").getSelectedOption();  // падало на этом шаге
  option.shouldNot(exist);

Теперь мы исправили это недоразумение. Лень победила! См. issue 1581 и PR 1864.

Обновили зависимости

Netty с 4.1.77.Final на 4.1.78.Final.
BrowserUp proxy с 2.1.5 на 2.2.0.

UPD Выпустили Selenide 6.6.5

И ещё мини-релиз Selenide 6.6.5.

Обновили Selenium с 4.2.2 на 4.3.0.

Это наш откровенный респонс на ваш откровенный реквест.

Андрей Солнцев

ru.selenide.org

Вышла Selenide 6.6.3

2022-06-12T00:00:00+00:00

Здравствуйте, друзья!

Мы выпустили мини-релиз Selenide 6.6.3.

Доработали таймаут для клика

В версии 6.6.0 мы добавили опциональный параметр - таймаут для метода $.click().
Но оказалось, что тот параметр решал лишь половину проблемы.

Теперь мы исправили и вторую половину: вызов

$("#slow-link").click(usingDefaultMethod().timeout(ofSeconds(8)));

ждёт до 8 секунд как появления элемента #slow-link, так и последующей загрузки страницы.

См. issue 1572 и PR 1853.

Selenide 6.6.2

А чуть раньше мы выпустили мини-релиз Selenide 6.6.2 с обновлением на Selenium 4.2.2

См. PR 1851.

Selenide 6.6.1

А чуть раньше мы выпустили мини-релиз Selenide 6.6.1 с исправлением старой issue 1850. Там мы вернули зависимость byte-buddy, без которой не работало добавление листенеров для вебдрайвера.

Андрей Солнцев

ru.selenide.org

Вышла Selenide 6.6.0

2022-06-08T00:00:00+00:00

Здравствуйте, друзья!

Мы выпустили релиз Selenide 6.6.0.

Появился новый плагин `selenide-clear-with-shortcut`

В Selenide 6.5.0 мы поменяли реализацию $.clear() со стандартной селениумовской на шорткат (“Выделить всё” - Удалить). Оказалось, что этот шорткат не работал достаточно стабильно во всех браузерах, пришлось его доработать. Вроде стабилизировался, но стал медленнее, чем просто WebElement.clear(). А поскольку это не всем нужно, решили в конце концов в Селениде оставить старую добрую селениумовскую реализацию.

А кому нужна очистка шорткатом - может подключить себе наш новый плагин:

  testImplementation('com.codeborne:selenide:6.6.0')
  testImplementation('com.codeborne:selenide-clear-with-shortcut:6.6.0')

Зависимость com.codeborne:selenide-clear-with-shortcut переопределит метод $.clear() - а соответственно, и $.setValue().

См. issue 1497, PR 1847 и PR 1838.

Исправили метод `$.clear()` в Safari

Внезапно выяснилось, что новый $.clear() не работал в Safari (кто его вообще использует?).
Вроде починили. Делитесь опытом, как у вас, починилось?

См. issue 1819, PR 1820.

Новые проверки для текста элемента

Добавили две новых проверки для “своего текста” (own text) элемента:

$("#child_div1").shouldHave(ownTextCaseSensitive("Son"));
$("#child_div1").shouldHave(exactOwnTextCaseSensitive("Son"))

Спасибо Kachurin Alexandr за PR 1811 и PR 1812.

Добавили метод `$.click()` с таймаутом

По умолчанию у метода $.click() стандартный селенидовский таймаут (который по умолчанию 4 секунды).
Иногда этого недостаточно - например,

Когда клик по ссылке ведёт на следующую страницу, которая грузится дольше 4 секунд.
Когда элемент, по которому нужно кликнуть, ещё не появился на экране - и появляется больше, чем через 4 секунды.

В этом релизе мы добавили таймаут методу $.click():

  $("#slow-link").click(usingDefaultMethod().timeout(ofSeconds(8)));
  $("#slow-link").click(usingJavaScript().timeout(ofSeconds(8)));

Правда, этот параметр решает пока только первую проблему, но не вторую. В следующем релизе займёмся и второй. :)

См. issue 1572 и PR 1845.

Добавили таймаут методам `confirm()`, `dismiss()` и `prompt()`

Издревле эти три метода позволяют работать с модальными джаваскриптовскими окошками (alert, confirm, prompt). Например,

confirm();
confirm("Are you sure you want to delete all files?");

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

confirm(withTimeout(ofSeconds(2)));
confirm(withExpectedText("Are you sure?").timeout(ofSeconds(2)));

См. issue 1721 и PR 1846.

Подправили метод `Driver.executeJavaScript()`

…чтобы он работал и с “завёрнутым” вебдрайвером (т.е. когда на вебдрайвер навешаны листенеры).

См. PR 1848.

Подправили формулировку некоторых проверок

… чтобы он звучали корректно по-английски. А именно:

В тесте	В отчёте было	В отчёте стало
`$.should(appear)`	“Element should visible”	“Element should be visible”
`$.should(disappear)`	“Element should hidden”	“Element should be hidden”

См. PR 1840.

Добавили опции для Safari

Выяснилось, что при открытии браузера Safari селенид терял почти все его настройки. Сломалось при переходе на Selenium 4. Починить это оказалось легко, но почему никто до сих пор не жаловался?

Похоже, Safari всё-таки никто не использует. :)

См. issue 1836 и PR 1841.

Починили софт ассерты на TestNG

После обновления на TestNG 7.5 перестали правильно работать селенидовские софт ассерты. Если какая-то проверка падала, тест по-прежнему оставался зелёным.

Пришлось откатиться до TestNG 7.4.0 и ждать исправления на той стороне.

См. issue 1834 и PR 1843.

Обновили зависимости

Selenium 4.1.4 -> 4.2.1.
WebDriverManager 5.1.1 -> 5.2.0

Статистика

Давно мы не публиковали статистика скачиваний Селенида

Мы почти вернулись к рекордному показателю: 324 тысяч скачек за май.

Не переключайтесь!

Андрей Солнцев

ru.selenide.org

Вышла Selenide 6.5.0

2022-05-17T00:00:00+00:00

Здравствуйте, друзья!

Мы выпустили релиз Selenide 6.5.0.

Теперь можно маскировать пароли в отчётах

Иногда в автотестах приходится вбивать в поля пароли и другие секретные данные. И некоторые люди переживают, что эти данные потом видны в отчётах (Allure или TextReport). И просят их как-нибудь скрыть.

Лично я не понимаю, почему кого-то должен волновать пароль от тестовой среды. (Вы же не используете одни и те же пароли во всех средах? Вы же не гоняете тесты на продакшине?)

Но мы пошли навстречу пожеланиям переживающих, и теперь вы можете маскировать или заменять секретные данные:

  $("#password").setValue(withText("admin").sensitive());
                                         // заменяет на звёздочки

  $("#username").setValue(withText("john").withDisplayedText("J* username"));
                                         // заменяет на "J* username"

См. issue 1768 и PR 1770.

Теперь можно легко выбрать дату в `<input type=date>`

Оказалось, что выбрать дату в селениуме не так-то просто.
Если в вашем приложении есть элемент вида <input type=date>, то при клике в него разные браузеры открывают разные календарики, и при этом используют разные форматы даты. По идее они должны использовать формат из настроек пользователя, но на деле каждый браузер играет в свою игру.

Всё это приводят к флейки тестам, которые могут работать на одном компьютере, но внезапно упасть на другом.

В результате моего исследования я пришёл к выводу, что единственный надёжный способ выбрать дату - это установить значение в фиксированном формате yyyy-mm-dd через JavaScript. Похоже, это работает одинаково во всех ОС и браузерах.

И теперь Селенид предоставляет такую возможность с помощью нового метода withDate:

  LocalDate birthday = LocalDate.parse("1979-12-31");
  $("#birthday").setValue(withDate(birthday));

См. issue 1753 и PR 1770.

Теперь метод `$.setValue("")` поддерживает React, Vue.js и т.п.

Давно замечено, что стандартный селениумовский метод WebElement.clean() (в частности, использующийся в селенидовском $.setValue()) не всегда правильно работает, когда имеют дело не с обычным <input>, а с обёрнутыми/обвязанными модными конструкциями, генерируемыми всякими современными JS-фреймворками типа React, Vue.js и прочей хипстоты.

По идее мы это починили, ждём ваших отзывов.

Теперь следующие методы реализованы не через стандартный селениумовский WebElement.clear(), а через нажатия комбинации клавиш:

1. Method `$.clear()`:

input.sendKeys(HOME, chord(SHIFT, END), BACK_SPACE);

2. Method `$.setValue("")`:

input.sendKeys(HOME, chord(SHIFT, END), BACK_SPACE, TAB);

Такой способ, похоже, работает во всех ОС и браузерах.

См. issue 1497 и PR 1787.

Спасибо Alexei Vinogradov за исследование проблемы в PR 1499.

Убрали двойное событие `blur` и `change`

Из предыдущего изменения автоматически следует, что метод $.setValue("blah") вызывает события blur и change только единожды.

А раньше метод $.setValue("blah") работал в два шага и вызывал их дважды:

Шаг 1. $.clear() // вызывало blur и change
Шаг 2. $.sendKeys("blah") // ещё раз вызывало blur и change

И события на первом шаге иногда приводили к неожиданным эффектам - например, исчезанию самого поля.
См. issue 960.

Вызываем событие `blur` на предыдущем элементе

В предыдущем пулреквесте заодно сделали так, что метод $.setValue("blah") вызывает событие blur на предыдущем активном элементе. Как минимум это помогло исправить некоторые наши флейки тесты. Надеемся, поможет и вам.

См. issue 1784 и commit 593e6fc9005.

Теперь методы `$.setValue()` и `$.append()` проверяют, что элемент не выключен

Точнее, что элемент не находится в состоянии “disabled” или “readonly”.

См. issue 1523 и PR 1787.

Добавили новые проверки “interactable” и “editable”

Эти проверки уже существовали и использовались раньше внутри Селенида, но не торчали наружу. А теперь и вы сможете их использовать:

$("input[type=file]").shouldBe(interactable);  
             // interactable = visible OR "opacity: 0"

$("input").shouldBe(editable);
             // editable = interactable AND enabled AND !readonly

См. issue 1523 и PR 1787.

Метод `$.download(FOLDER)` дожидается полной загрузки файла

Британские учёные обнаружили, что иногда флейки тесты вызваны тем, что файл скачивается довольно медленно, и селенид успевает обнаружить и скопировать к себе файл, который уже появился в C:\Downloads, но ещё не полностью загружен.

Теперь селенид ждёт, пока в C:\Downloads исчезнут все файлы “.crdownload” (для хрома) и “.part” (для фаерфокса). Это временный файл, создаваемый браузером на короткий период, пока скачивается файл.

См. issue 1779, PR 1804 и PR 1769.

Добавили метод `stream()` для коллекций

Точнее, метод $$.stream() существовал и раньше, но в версии 6.2.0 был помечен как deprecated. Теперь вместо него есть на выбор два не-deprecated метода:

$$.asFixedIterable().stream()
$$.asDynamicIterable().stream()

См. issue 1773 и PR 1774.

Удалили встроенную селениумовскую телеметрию (OpenTelemetry)

Я так понимаю, эта телеметрия появилась в Selenium 4. Не знаю, зачем она вообще нужна, но кому-то мешала (потому, что у него уже была какая-то своя телеметрия). Ну и нам было проще её удалить, чем поддерживать обе.

Спасибо Petro Ovcharenko и Aliaksandr Rasolka за PR 1763.

Обновили зависимости

Кстати, проект LittleProxy переехал в отдельную организацию на гитхабе, и теперь я его главный мейнтейнер. Не то, чтобы я был фанатом проксей, но он используется в селениде, и поддерживать его как-то надо…

UPD Selenide 6.5.1

Небольшое обновление Selenide 6.5.1:

#1808 Починили $.clear(), чтобы он не жмякал таб - см. PR #1809
#1806 Обновились с browserup-proxy-core 2.1.4 на 2.1.5

UPD Selenide 6.5.2

#1497 Починили $.clear() на свежем фаерфоксе: теперь жмякаем “Ctrl+A -> Delete” вместо “Home -> Shift+A -> Delete”. См. PR #1838.

Новости

Отдельный привет всем, кто ждал, что же тут будет в конце пресс-релиза. ;)

А будет моя презентация с последнего фестиваля TechTrain.

Видео с TechTrain будет через несколько месяцев, а пока можете посмотреть похожее видео из девклуба. Оно немного другое, ибо ориентировано на другую аудиторию, но общее представление получить можно.

Не переключайтесь!

Андрей Солнцев

ru.selenide.org

Вышла Selenide 6.4.0

2022-04-07T00:00:00+00:00

Здравствуйте, друзья!

Мы выпустили релиз Selenide 6.4.0.

Показываем и алиас, и локатор при падении тестов

Как вы знаете, в Селениде с помощью метода as можно задавать элементам “алиас”, или понятное имя. Это полезно в тех случаях, когда нет хорошего локатора, и приходится писать какой-нибудь длинный сложный xpath, который потом в отчётах сложно читать.

Например:

$x("/long/ugly/xpath/div[2]/span[3]/li[4]").as("Login button").click();

И у нас всегда была дилемма: нужно ли

показывать только алиас (плюс: легко читается, минус: не видно селектора - вдруг он нужен?)
показывать и алиас, и селектор (плюс: видно селектор, минус: трудно читается).

И вот наконец мы поняли, как правильно. Начиная с версии 6.4.0, селенид будет:

В отчётах на каждом шаге показывать только алиас (коротко, легко читается)
А вот при падении теста в сообщение об ошибке добавлять и алиас, и локатор (длинно, зато будет вся необходимая информация для изучения падения).

Например, вышеупомянутая строка в отчётах будет выглядеть вот так:

+----------------------+--------------------+------------+------------+
| Element              | Subject            | Status     | ms.        |
+----------------------+--------------------+------------+------------+
| Login button         | click()            | FAIL       | 206        |
+----------------------+--------------------+------------+------------+

А сообщение об ошибке - так:

Element "Login button" not found {By.xpath: /long/ugly/xpath[1][2][3]}
Expected: exist
Screenshot: ...

См. issue 1765 и PR 1766.

Добавили пробелы в селенидовском отчёте

Например, вышеупомянутый отчёт раньше выглядел так:

+---------------------+-------------------+------------+------------+
|Element              |Subject            | Status     | ms.        |
+---------------------+-------------------+------------+------------+
|open                 |https://google.com/some-long-url.html?q=selenide|PASS       |1285       |
|Login button         |click()            | FAIL       | 206        |
+---------------------+-------------------+------------+------------+

Проблема была как минимум в том, что вокруг URL слева и справа вплотную прилегают символы |, так что его невозможно быстро выделить двойным кликом. Теперь вокруг URL и других значений будут пробелы. Заодно отчёт и покрасивее стал.

См. issue 1764 и PR 1767.

Обновились на Selenium 4.1.3

См. ченджлог Selenium и PR 1759.

ВАЖНО

Меня зовут Андрей Солнцев, я 10 лет делаю библиотеку Selenide и делюсь опытом на конференциях.
Просто так, бесплатно. Я у вас никогда ничего за это не просил.

А теперь я прошу всего лишь услышать меня. Вот как вижу ситуацию я - в целом неглупый человек, мнение которого, надеюсь, стало для многих из вас авторитетным за эти 10 лет.

Россия начала войну в Украине. Бессмысленную и бесчеловечную.

Там сейчас под бомбёжками, под обстрелами сидят мирные люди, которые никому ничего плохого не сделали.
В том числе и пользователи селенида.

Те, перед которыми я многократно выступал на конференциях.
Те, которых я слушал и учился.
Те, которые помогали развивать селенид, и результатами работы которых пользуются люди во всём мире, в том числе и России. Пользуетесь лично вы.

Это тяжело признать, об этом тяжело думать, от этого ужаса хочется спрятаться - но такова реальность.

Я не знаю, как это остановить.
Но я прошу вас хотя бы не поддерживать это.
Я призываю вас не верить этой чудовищной лжи про нацистов, расширение НАТО, фейки и т.п.
Я прошу вас оставаться людьми.

Андрей Солнцев

ru.selenide.org

Вышла Selenide 6.3.0

2022-02-07T00:00:00+00:00

Здравствуйте, друзья!

Мы зарелизили Selenide 6.3.0.

Приготовьте бутеры и погнали!

Добавили метод `switchTo().frame(timeout)` с кастомным таймаутом

В селениде есть метод switchTo().frame(name) для переключения между фреймами. Как всегда, со встроенной ожидалкой и другими плюшками. Но что, если фрейм грузится дольше, чем таймаут по умолчанию (4 секунды)?

Теперь вы можете передать дополнительный параметр Duration - таймаут для переключения во фрейм:

  switchTo().frame("ifrm");                          // по умолчанию ждёт до 4 секунд
  switchTo().frame("ifrm", Duration.ofSeconds(6));   // а вот теперь до 6 секунд

Спасибо @donesvad за PR 1722.

Добавили селекторы `byTagAndText` и `withTagAndText`

До сих пор в селениде были методы для поиска элементов по тексту:

  import static com.codeborne.selenide.Selectors.*;

  $(byText("Hello world")).shouldHave(text("Hello World"));
  $(withText("Hello")).shouldHave(text("Hello World"));

Иногда этого мало: когда элементов с таким текстом несколько, и хочется из них выбрать только один - с нужным тэгом.

Теперь и для этого есть методы:

  import static com.codeborne.selenide.Selectors.*;

  $(byTagAndText("h1", "Hello world")).shouldHave(text("Hello World"));
  $(withTagAndText("h1", "Hello")).shouldHave(text("Hello World"));

Спасибо Maurizio Lattuada за issue 1650 и PR 1651.

Исправили ошибку в `byTextCaseInsensitive`

Теперь этот селектор игнорирует множественные пробелы и переводы строк в начале и конце текста (как и каноничный byText).

См. issue 1723 и PR 1724.

Добавили записи “webdriver create” в “webdriver close” в отчёт

Если вы используете селенидовский TextReport или плагин AllureSelenide, вы привыкли в конце каждого теста видеть отчёт, в котором видны все действия: открыли страничку - нашли элемент - кликнули и т.д.

Теперь там добавилась запись, когда был запущен сам вебдрайвер. И когда закрыт. Иногда эта информация может быть полезна при отладке различных проблем с тестами.

Спасибо Petro Ovcharenko за PR 1715.

Исправили переопределение селениумовского таймаута

В Selenide 5.22.0 мы сделали хак, который менял дефалтовый селениумовский таймаут для общения с вебдрайвером с дичайших 3 часов до 2 минут.

Однако выяснилось, что при обновлении на Selenium 4 этот хак сломался (как и положено всем хакам). Теперь мы его реанимировали.

Напоминаю, теперь при общении между тестами и вебдрайвером таймаут такой:

таймаут на соединение - 10 секунд
таймаут на чтение - 1.5 минуты

См. commit cf02da5.

Убрали двойное заворачивание ошибок “Element not found” друг в друга

См. issue 1705 и PR 1706.

Добавили поддержку типа аутентификации `BEARER`

В селениде давно уже есть способ аутентификации с разными типами:

open("/basic-auth/hello", BASIC, "scott", "tiger");

но точно правильно работал только тип BASIC. Остальные особо никто не проверял. :)

Оказалось, что тип BEARER не работал. Теперь вот работает (а остальные по-прежнему никто не проверял :)).

Использовать так:

    open("/bearer-token-auth/hello", BEARER, new BearerTokenCredentials("token-123"));

См. PR 1714.

Теперь пустые настройки типа `selenide.remote` считаются незаданными

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

-Dselenide.remote=${env.GRID_URL}

И если в какой-нибудь среде переменной GRID_URL не окажется, то селенид грохнется, т.к. попытается использовать пустой урл для selenide.remote.

Так было раньше. А теперь селенид будет считать, что selenide.remote просто не задан, и продолжить работать как обычно.

См. Alexei Vinogradov за issue 1656 и Boris Osipov за PR 1663.

Обновились на Selenium 4.1.2

После обновления на Selenium 4.1.2 у многих слетела версия Guava. Селенид явно определяет нужную версию Guava, так что вас эта проблема затронуть не должна. Но если что, убедитесь, что в вашем проекте никакой там градловский или мавеновский плагин не переопределяет версию Guava. Старый добрый пост про зависимости в помощь.

См. ченджлог Selenium и PR 1719.

UPD Selenide 6.3.1

Небольшое обновление Selenide 6.3.1:

#1731 вернули возможность использовать софт ассерты в TestNG в методах @Before* и @After* (ранее мы их случайно запретили в Selenide 6.2.0) - см. PR #1732
#1729 Обновились с Netty 4.1.73.Final на 4.1.74.Final

UPD Selenide 6.3.2

Ещё обновление Selenide 6.3.2:

#1733 Запилили костыль для баги селениума 10345, из-за которой метод FirefoxDriver.close() валится после обновления на Firefox 97.
#1736 Обновились с BrowserUpProxy 2.1.3 на 2.1.4
#1611 Обновили версию Java с 8 до 17.

А вот тут давайте остановимся поподробнее. Теперь проект Selenide собирается на Java 17, но бинарники selenide-*.jar по-прежнему собираются для Java 8. Поэтому

разработчики селенида могут использовать все последние фичи языка Java, а
пользователи селенида могут по-прежнему запускать свои тесты на Java 8 (хоть мы и советуем обновить джавушку, конечно).

А стало это возможным благодаря инструменту Jabel и лично Sergei Egorov, придумавшему этот изящный хак (а ещё причастному к TestContainers и AtomicJar).

UPD Selenide 6.3.3

Ещё обновление Selenide 6.3.3:

#1737 позволили переопределять настройки Firefox для скачивания файлов
#1740 обновились на WebDriverManager 5.1.0

UPD Selenide 6.3.4

Ещё обновление Selenide 6.3.4:

#1746 показываем ожидаемый атрибут при падении $.shouldHave(attribute(...)).
#1748 исправили имя модуля в сгенерированных бинарниках селенида

UPD Selenide 6.3.5

Ещё обновление Selenide 6.3.5:

#1755 починили скачивание файлов через прокси, если ответ сервера закодирован - см. PR #1756

Новости

Мы создали группу в LinkedIn Selenide User Group!
Пост от Miklós Szeles Selenium or Selenide?
Селенид попал в подборку 5 Testing Automation Tools в блоге компании Qameta Software (это которая Allure Report)
Селенид попал в подборку Top Java Libraries for Automation Testing in 2022
Пост про Селенид в блоге компании Knoldus
Пост The software that doesn’t need documentation от Gaveen Nayanajith
Пост начало прекрасной дружбы от Miklós Szeles

Я думаю, это начало прекрасной дружбы!

Андрей Солнцев

ru.selenide.org

Вышла Selenide 6.2.0

2022-01-10T00:00:00+00:00

С новым годом!

Мы зарелизили Selenide 6.2.0.

Давайте посмотрим, что нам приготовил первый релиз в новом году.

Наливайте чай и погнали!

Добавили ссылку “<Click to see difference>” для большинства селенидовских ошибок

Как вы помните, в Selenide 5.25.0 мы добавили поддержку OpenTest4J, в результате чего у селенидовских ошибок в IDE появилась ссылочка “<Click to see difference>”, позволяющая удобно посмотреть различия между ожидаемым и актуальным значением.

Но тогда мы всё порефакторить не успели, и ссылочка появилась не у всех типов ошибок.
А теперь должна появиться у всех.

См. issue 1589 и PR 1676.

Заменили `$$.iterator()` на `$$.asDynamicIterable()` и `$$.asFixedIterable()`

Ух какую старую болячку мы исправили! Ну молодцы же!

Есть в селениде метод $$ для коллекции элементов. Возвращает он объект класса ElementsCollection.
Изначально у него должен был быть только один метод $$.shouldHave(<условие>). Хочешь проверить коллекцию элементов на соответствие какому-то условию - передай нужное условие. Не нашёл готового условия - напиши своё, благо это легко.

The ошибка

Но в те давние времена случилось так, что я наследовал класс ElementsCollection от AbstractList<SelenideElement>. Об этом решении я неоднократно жалел впоследствии.

Что же случилось, спросите вы? А случилось то, что люди начали абьюзить коллекции как не в себя.

Например, начали итерировать все элементы в коллекции (это случайно стало возможным благодаря наследованию от AbstractList).
И ещё люди ожидают, что элементы в коллекции будут постоянно обновляться, ведь до сих пор селенид автоматически обновлял любые веб-элементы.
Помимо сомнительного тест-дизайна, это вызвало ещё и проблемы с производительностью, ведь на каждом шаге итерации селенид должен загрузить заново всю коллекцию элементов. А это может быть медленно, особенно есть элементов много или коллекция фильтруется: $$("div").filter(visible).filterBy(text("Hello")).

The дилемма

Получилась дилемма:

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

Какой вариант ни выберешь - всем не угодишь.

The решение

И наконец мы придумали, как решить эту дилемму. Случайно унаследованные от AbstractList методы типа $$.iterator() мы пометили как @Deprecated. Вместо них предлагаем вам два метода, из которых вы сами сможете выбрать согласно вашим потребностям:

$$.asDynamicIterable() - перегружает элементы коллекции при итерировании. Может быть медленным на больших коллекциях.
$$.asFixedIterable() - не перегружает элементы при итерировании. Он быстрее, но не получает обновлений, если элементы удаляются или добавляются во время итерирования.

The совет

Какой из них я вам советую?

НИКАКОЙ! :)

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

Вместо итерирования всегда лучше написать свой CollectionCondition. Благо это легко.

См. issue 797 и PR 1688.

Исправили SoftAssert, чтобы он не валил тест

в довольно редкой ситуации:

если софт ассерт listener/rule/extension добавлен к тесту, но
софт ассерты выключены, и
внутри теста кидается и тут же ловится ошибка (try/catch).

Вообще в такой ситуации надо исправлять сам тест. :(

И всё же. До сих пор селенидовский софт ассерт валил тест, потому что в ходе теста была ошибка, и листенер это заметил. А теперь листенер стал чуть умнее и тест не валит.

Уф, ну и проблемки вы иногда подкидываете, дорогие пользователи… :)

См. issue 1646 и PR 1680.

Исправили софт ассерты, чтобы они включали все падения

Ещё одна редкая проблема с софт ассертами. Представьте ситуацию:

Софт ассерты включены;
В ходе теста случились какие-то селенидовские ошибки (пойманы софт ассерт листенером);
А также в ходе теста случилась какая-то другая ошибка (банальный NPE или assertEquals(2, 3)).

В этом случае селенидовский софт ассерт листенер валил тест (что правильно), но показывал только селенидовские ошибки (п. 2) и терял “другую” ошибку (п.3).

Теперь листенер стал умнее, и показывает все ошибки.

См. issue 1661 и PR 1679.

Добавили локаторы к некоторым селенидовским ошибкам

Мелочь, но стоит упомянуть.

Мы добавили селектор к некоторым селенидовским ошибкам.
Например, там, где селенид раньше кидал такую ошибку:

“Invalid element state: Cannot change invisible element”

Теперь он будет кидать такую:

“Invalid element state [.btn.btn-primary]: Cannot change invisible element”

Обновили BrowserUpProxy с 2.1.2 на 2.1.3

Важно отметить, что версия 2.1.3 - это форк оригинального BrowserUpProxy. Автор объявил о прекращении поддержки, добровольцы переняли инициативу и зарелизили версию 2.1.3 из форка.

Будем следить за ситуацией. В идеале хорошо бы перейти с BrowserUpProxy на mitmproxy. Есть добровольцы?

См. PR 1678.

Обновили TestNG с 7.4.0 на 7.5

Список изменений внушительный.

См. PR 1682.

С Новым Годом, друзья!
Стабильных тестов вам и красивых отчётиков!

Андрей Солнцев

ru.selenide.org

Вышла Selenide 6.1.1

2021-11-24T00:00:00+00:00

TERE HOMMIKUST!

Мы зарелизили Selenide 6.1.1.

В этом маленьком релизе мы исправили сразу пачку проблем с настройками браузеров.
Они все всплыли после обновления на Selenium 4, в котором ChromeOptions и другие Capabilities были серьёзно переработаны.

Ну вот, теперь мы погрузились в тему и разом все проблемы исправили.

Раннее обнаружение конфликтов

Если вы попытаетесь открыть хром с настройками файерфокса:

Configuration.browser = "chrome";
Configuration.browserCapabilities.setCapability(FIREFOX_OPTIONS, new FirefoxOptions());

то Селенид версии 5.x ругался, а Селенид 6.0.x перестал ругаться. Теперь мы ругань восстановили, и вы снова увидите старое доброе

IllegalArgumentException: Conflicting browser name: ‘chrome’ vs. ‘firefox’

См. issue 1591 и PR 1642.

Слияние аргументов хрома

Если вы попытаетесь задать хрому, например, полноэкранный режим или язык:

ChromeOptions options = new ChromeOptions();
options.addArguments("--start-fullscreen", "--start-incognito");
options.setExperimentalOption("prefs", ImmutableMap.of("intl.accept_languages", "de_DE"));
Configuration.browserCapabilities = chromeOptions;
open("https://codeborne.com";)

то эти настройки терялись в Selenide 6.0.x Теперь мы их восстановили.

См. issue 1626, issue 1630 и issue 1631.

Исправление в PR 1642.

ВАЖНО

Если вы использовали Configuration.browserCapabilities, то с большой вероятностью заворачивали их в DesiredCapabilities:

ChromeOptions options = new ChromeOptions();
options.addArguments(...);

DesiredCapabilities caps = new DesiredCapabilities();
caps.setCapability(ChromeOptions.CAPABILITY, options);
Configuration.browserCapabilities = caps;

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

ChromeOptions options = new ChromeOptions();
options.addArguments(...);
Configuration.browserCapabilities = options;

Поменяли тип параметра в `WebDriverProvider`

… с DesiredCapabilities на просто Capabilities.

Для вас почти ничего не меняется. Если вы используете в своих тестах WebDriverProvider, просто поменяйте DesiredCapabilities на Capabilities, и всё будет по-старому.

См. PR 1642.

Больше капабилитей богу капабилитей!

UPD Selenide 6.1.2

Мы выпустили Selenide 6.1.2 с обновлением на Selenium 4.1.1 - эта версия содержит несколько заметных исправлений.

Андрей Солнцев

ru.selenide.org

Вышла Selenide 6.1.0

2021-11-23T00:00:00+00:00

TERE!

Мы зарелизили Selenide 6.1.0.

Добавили поддержку `selenide.properties`

Теперь Селенид умеет читать настройки из отдельного файлика selenide.properties, если таковой найдётся в classpath.

NB! Лично я всё ещё не вижу пользы от этого, ведь проще задать настройки

прямо в коде: Configuration.timeout = 8000;
или через system properties: -Dselenide.timeout=8000.

Прошу, не надо резко ломиться генерировать эти файлики. Используйте selenide.properties, только если у вас есть хорошие причины для этого, а не просто потому, что теперь это модно или “так красиво”.

Спасибо Petro Ovcharenko за PR 1601.

Добавили возможность тонкой настройки прокси

Как вы знаете, Селенид умеет запускать свой прокси-сервер, который даёт нам некоторые дополнительные возможности. Но возможности для настройки прокси до сих пор были ограниченные. Только Configuration.proxyHost и Configuration.proxyPort.

Теперь же можно будет получить инстанс BrowserModProxy и настроить его как угодно до запуска браузера.

NB! Пожалуйста, не переусердствуйте с этим. Тут очень легко выстрелить себе в ногу.

И если ваши настройки действительно помогли вам, то возможно, они помогут и другим. Расскажите нам, что вы там такого настроили - может, стоит сделать это в селениде по умолчанию?

См. issue 1561. Спасибо Boris Osipov за PR 1620.

Добавили костыль для избежания случайных `NoClassDefFoundError` в `WebDriverException`.

В Селениум есть бага, которая полностью до сих пор не исправлена. Но вы её больше не увидите, потому что теперь в селениде есть костыль против неё. :)

См. костыль.

Поменяли тип параметра `SelenideConfig.browserCapabilities()`

… с DesiredCapabilities на MutableCapabilities.

Это позволяет упростить ваш код и не заворачивать ChromeOptions в DesiredCapabilities. Больше об упрощении капабилитей этом будет в следующем релизе Selenide 6.1.1.

См. PR 1637.

Обновились на Selenium Webdriver 4.1.0

Спасибо Boris Osipov за PR 1638.

Удалили метод `$.shadowRoot()`

Этот метод сломался после обновления на Chrome 96, и вероятно, вскоре сломается и в остальных браузерах. Починить его муторно, и при этом пользы от этого метода немного, ведь для поиска элементов внутри Shadow DOM есть более удобные и быстрые методы.

См. issue 1640 и PR 1641.

Новости

Первый TestOps Hackathon от PropellerAds и Qameta Software перенесли на 1-6 декабря. Регистрируйтесь!
Как использовать Selenide с сервисом Lambdatest
Пост Selenide - Create a Custom WebDriver от Boris Bay
Оказывается, LinkedIn проводит курсы по Селениду и даже выдаёт красивенькие дипломы.

Статистика использования Селенида

В октябре мы сделали мощный скачок и перевалили за 280 тысяч скачиваний в месяц. Эгегей!

Больше скачиваний богу скачиваний!

Андрей Солнцев

ru.selenide.org

Вышла Selenide 6.0.1

2021-10-25T00:00:00+00:00

День рождения!

Ура! Сложно поверить, но сегодня Селениду исполняется… 10 лет!
Именно в этот день 10 лет назад был сделан первый коммит в репозитории.

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

Ну а мы в честь юбилея зарелизили мажорную версию Selenide 6.0.1.

Обновились на Selenium Webdriver 4.0.0

Если вы не используете Grid, то для вас особо ничего и не должно поменяться. Всё более-менее работает как раньше. Ну там, переименовали или задеприкейтили некоторые классы, вроде нестрашно.

В Selenium 4 появились и новые возможности (такие как CDP и Relative locators), но какой-то отдельной поддержки для них в селениде мы пока не делали. Если понадобится, будем делать в следующих версиях.

См. issue 1162, PR 1605, PR 1614 и PR 1617.

Разбили Selenide на несколько артефактов

Раньше весь код селенида поставлялся одним джарником: selenide-5.25.0.jar.
Предполагалось, что дополнительно к нему вы должны были сами добавить и другие зависимости: JUnit или TestNG, и возможно, BrowserMobProxy.

Теперь же мы решили упростить вам задачу (особенно с прокси).

Для пользователей Selenide и JUnit5 ничего не меняется:
testImplementation("com.codeborne:selenide:6.0.1)
Пользователи JUnit4 должны будут использовать
testImplementation("com.codeborne:selenide-junit4:6.0.1)
Пользователи TestNG должны будут использовать
testImplementation("com.codeborne:selenide-testng:6.0.1)
Если вы хотите использовать прокси, достаточно добавить в проект зависимость
testImplementation("com.codeborne:selenide-proxy:6.0.1) - и можно больше не заморачиваться с версиями BrowserUpProxy, Netty и т.п.
Ну и если среди вас есть радикальные ненавистники статических методов, теперь и вы сможете быть счастливы, используя
testImplementation("com.codeborne:selenide-core:6.0.1) - и тогда у вас в проекте не будет статических методов Selenide.*, а только чистый SelenideDriver.

См. PR 1612.

Подчистили кучу deprecated методов

По этой ссылке всегда можете найти, что именно удалили и чем это заменить.
В частности,

ElementsCollection.shouldHaveSize() -> ElementsCollection.shouldHave(size())
$.waitUntil(_, timeout) -> $.should(_, Duration.ofMillis(timeout))
$.waitWhile(_, timeout) -> $.shouldNot(_, Duration.ofMillis(timeout))
Condition.disappears -> Condition.hidden
Condition.matchesText -> Condition.matchText
Selenide.close -> Selenide.closeWebDriver() или Selenide.closeWindow()

Спасибо Boris Osipov за PR 1607 и PR 1609.

Удалили поддержку браузера “legacy_firefox”

Это был такой старый вебдрайвер, который работал только с Firefox 52 и старше. Полагаю, ему пора на покой.

См. PR 1610.

Удалили старые настройки

`Configuration.startMaximized`

Есть мнение, что это плохая практика, потому что размер окна браузера зависит от текущего окружения, что может привести к моргающим тестам. Рекомендуем использовать Configuration.browserSize (по умолчанию 1366x768).

`Configuration.versatileSetValue`

Скорее всего вы её и не использовали, ведь она давным-давно была false по умолчанию.
Для выбора значений в <select> и <input type=radio> можно использовать старый добрые методы $.selectOptionByValue() и $.selectRadio().

Спасибо Boris Osipov за PR 1619.

Починили метод `Selenide.sleep(N)`

Казалось бы, разве такой просто однострочный метод может быть сломан? А вот может. Оказывается, стандартный джавовый метод Thread.sleep(N) не обязательно спит именно N мс, он может проснуться и раньше. И это может привести к моргающим тестам, если ваш тест рассчитывал именно на определённую паузу. Век живи - век учись.

Теперь метод Selenide.sleep(N) гарантированно спит заданное количество миллисекунд.

См. реализацию.

Добавили метод для добавления и удаления `WebDriverListener`

Раньше в селениде можно было добавлять WebDriverEventListener, но этот класс был заменён на WebDriverListener в Selenium 4. Ну вот, пришлось поддерживать оба.

См. issue 1615 и PR 1616.

Поменяли сигнатуру метода `Condition.apply`

Если вы не писали свои Conditions, то вас это не касается.

А если успели наваять, то придётся их немножко дополнить.

Итак, раньше в классе Condition был метод apply, который возвращал boolean:

public boolean apply(Driver driver, WebElement element) 

Теперь его нужно переименовать в check, и возвращать он должен не просто boolean, а CheckResult:

public CheckResult check(Driver driver, WebElement element) 

А этот CheckResult содержит не только признак “проверка прошла / не прошла”, но и какое значение было у элемента в тот момент. Это позволить формировать более точное сообщение об ошибке в случае падения теста.

P.S. Впрочем, старый метод apply всё ещё остался как deprecated, поэтому какое-то время вы можете сидеть на старых кондишинах. Просто при падении теста строчка “Actual value: “ не будет добавляться к сообщению об ошибке. Но это и не всегда критично.

См. issue 217, PR 1586 и PR 1618.

selenide-selenoid 2.0.1

Мы выпустили selenide-selenoid:2.0.0 с обновлением на Selenide 6.0.1

selenide-appium

Кажется, пока что Appium не поддерживает Selenium 4, так что selenide-appium пока обновить не можем. Будет следить за ситуацией.

UPD Selenide 6.0.2

Обнаружилась проблемка с проектами на TestNG, по-быстрому выпустили хотфикс 6.0.2.

См. issue 1623

UPD Selenide 6.0.3

Оказалось, что Maven может подтягивать старый selenium-api-3*.jar, если он найден в дереве зависимостей (обычно у BrowserUpProxy или Allure).

Мне давно кажется, что тут Maven мог бы быть чуточку поумнее и выбирать всё-таки более свежую версию.
Но поскольку люди довольно часто наступают на эти грабли, мы решили запилить костыль в селениде.

См. костыль 1625

Что почитать про Selenium 4

What’s New In Selenium 4? by Applitools
Selenium 4: Understanding Key Features by BrowserStack
A comprehensive guide to Selenium 4 by SauceLabs
What Is New In Selenium 4 And What Is Deprecated In It? by LambdaTest
Обновлённый сайт Selenium

Другие новости

внезапный выпуск Heisenbug Show, посвящённый 10-летию Селенида.
Первый TestOps Hackathon от PropellerAds и Qameta Software - с 12 по 16 ноября. Регистрируйтесь!
Ребята из Aerokube выпустили альтернативный клиент WebDriver. Теоретически теперь селенид может работать на нём вместо Selenium Webdriver. Звучит заманчиво?
Koncerns: Почему я не тороплюсь на Котлин
Я пока не разбирался, но люди вроде хвалят: какие-то образы Docker для Selenium

Статистика использования Селенида

Перевалили за 255 тысяч скачиваний в месяц.

Что нас ждёт впереди?

Андрей Солнцев

ru.selenide.org

Вышла Selenide 5.25.0

2021-09-28T00:00:00+00:00

Добрый вечер!

Мы зарелизили Selenide 5.25.0.

Очень советую обновиться,
потому что за этим релизом грядут ещё большие изменения, включая полноценный релиз Selenium 4.
Если не обновитесь сейчас, потом будет намного сложнее разгребать завалы!

Это прямо большой релиз с кучей изменений, так что запаситесь попкорном и заварите чаю. Погнали!

Поддержка Selenium Webdriver 4.0.0 RC1

Мы выпустили две сборки Selenide 5.25.0: обычную и хипстерскую.
Можете сами выбрать:

либо	`com.codeborne:selenide:5.25.0`	(с `Selenium 3.x`),
либо	`com.codeborne:selenide:5.25.0-selenium-4.0.0-rc-1`	(с `Selenium 4.0.0 RC1`).

Добавили поддержку OpenTest4j

Если вы ещё не слышали, OpenTest4j - это маленькая библиотека для assertion errors, созданная по инициативе ребят из JUnit 5. Идея в том, чтобы все тестовые фреймворки кидали именно эти ошибки, а все IDE их поддерживали. Её уже давно поддерживают крупные игроки типа JUnit, TestNG, AssertJ, IDEA и Eclipse, а вот теперь ещё и Selenide.

Что изменится лично для вас:
Когда ваш UI тест падает (ну, почти всегда), IDEA теперь красивенько показывает внизу ссылочку <Click to see difference>. Вы можете её кликнуть и увидеть красивый идеевский DIFF в отдельном диалоге. Очень удобно при отладке.

См. issue 969 и PR 1545.

NB! Если вы в своих проектах использовать напрямую селенидовские классы ошибок (наследовали или кидали), то придётся чуть подпилить код, потому что мы чутка изменили сигнатуры их конструкторов:

поменяли местами аргументы “expected” и “actual”
убрали ненужный параметр “driver” из большинства конструкторов

Показываем стектрейс под каждой ошибкой в SoftAsserts

До сих пор селенидовские софт ассерты показывали только один общий стектрейс после всех ошибок. А удобнее видеть стектрейс под каждой, тогда легко кликнуть на нужную строчку и попасть сразу в нужное место в коде.

Теперь стектрейс будет под каждой ошибкой. Правда, теперь общее сообщение об ошибке стало гораздо длиннее, но ведь их не должно быть часто и много, правда? ;)

См. issue 1543 и PR 1545

Добавили метод `$.shadowRoot()`

Раньше можно было только искать элементы внутри shadow root, а теперь можно получить и сам shadow root. Правда, пользы от этого пока немного, т.к. поиск внутри этого элемента не поддерживается (браузерами или вебдрайверами, я уж не знаю - запутался).

См. issue 1515 и PR 1517.

Добавили метод `$.ancestor()`

По сути это просто синоним к существующему методу $.closest(). Но только название closest было родом из JQuery (олды помнят!), а ancestor должно быть более понятным, т.к. это общеизвестный термин из XPath.

См. issue 1556.
Спасибо Oleg Berezhnoy за PR 1567

Обогатили методы `$.closest()` и `$.ancestor()`

Раньше этот метод умел искать элемент только по тэгу или классу:

$.ancestor("table").shouldBe(visible)
$.ancestor(".form").shouldBe(visible)

То теперь добавился поиск по атрибуту:

$.ancestor("[argument-name]");
$.ancestor("[argument-name=argument-value]");

Спасибо Vitali Plagov за PR 1554

Починили метод `$.screenshot()` на маках

В селениде уже давно есть метод $.screenshot(), который позволяет сделать снимок не всего экрана, а только указанного элемента. Оказалось, что этот метод неправильно работал на MacBook: вырезал не ту область экрана (из-за всей этой чехарды с пикселями на дисплее Retina).

К счастью, мы обнаружили, что соответствующий функционал уже давно реализован в селениуме, поэтому мы вырезали костыльный код из селенида и использовали стандартный метод вебдрайвера. Работает как минимум на Chrome, Firefox, Edge.

См. issue 1571 и PR 1576.

При падении текстовых проверок селенид выдаёт точное значение на момент падения

Ничего себе, какие старые болячки мы иногда чиним! Этот тикет был зарегистрирован аж 6 сентября 2015!

В общем, история такая.

Допустим, в вашем тесте есть проверка

$.shouldHave(text("Hello"));

И стандартный таймаут в 4 секунды. И вот:

в течение 4 секунд селенид проверяет-проверяет текст, а он всё не тот и не тот (допустим, “Goodbye”).
таймаут истекает,
селенид решает кинуть ошибку,
начинает составлять сообщение и добавляет к нему текущий текст элемента - а он как раз в этот момент взял и да поменялся! Допустим, на “Hello”.

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

Текст не совпал. Ожидался: Hello, а был: Hello.

и чувствуете, как мозг начинает подгорать…

Теперь Селенид запоминает именно тот текст, который был на момент проверки, и именно его добавляет в сообщение об ошибке. Да здравствуют неподгоревшие мозги!

P.S. В будущем мы планируем этот механизм ещё больше усовершенствовать, и выводить всю историю изменений текста в течение этих несчастных 4 секунд. Больше отчётов богу отчётов!

См. issue 217 и PR 1566.
Спасибо Pavel Fokin за PR 1313.

Запретили пустой аргумент в методе `$.matchText("")`

В селениде есть метод для проверки текста элемента регулярным выражением:

$("#child_div1").should(matchText("Таллин{1,2}")));

И тут мы обнаружили, что метод matchText позволяет передать ему пустую строку, что можем привести к ложно-зелёным тестам. Теперь же при попытке вызвать $.should(matchText(""))) вы сразу увидите такую ошибку:

java.lang.IllegalArgumentException: Argument must not be null or empty string

См. PR 1566

Добавили проверку `webdriver().shouldHave(title(...))`

Как обычно, есть варианты со стандартным таймаутом и кастомным:

webdriver().shouldHave(title("Login page"));
webdriver().shouldHave(title("Login page"), ofMillis(10));

См. issue 1573.
Спасибо Ervīns Patmalnieks за PR 1579.

selenide-selenoid 1.2.0

Мы выпустили selenide-selenoid:1.2.0 с обновлением на Selenide 5.25.0

selenide-appium 1.7.0

Мы выпустили selenide-appium:1.7.0 с обновлением на Selenide 5.25.0

Ссылки

Вышло моё интервью с Лёшей Маршалом на ютуб канале “Тестирование ПО”
5-7 октября снова будет Гейзенбаг - советую!
Доклады с весеннего Гейзенбага
- В т.ч. мой доклад Flaky tests. Метод
- В т.ч. мой мастер-класс Как начать проект автоматизации. Продолжение. - часть 1, часть 2.
Лекция Автоматизация для QA: Selenide
Пост Using Selenide & TestNG

Статистика использования Селенида

Знаковый рубеж пройден: перевалили за 250 тысяч скачиваний в месяц.

Юбилей

Кстати, мы вплотную подошли к ещё одному знаковому рубежу: в октябре Селениду исполняется… 10 лет!
В это сложно поверить, но первый коммит в репозитории был сделан аж 25 октября 2011 года. Вы только посмотрите, какой он был нелепый! :)

Андрей Солнцев

ru.selenide.org

Вышла Selenide 5.24.0

2021-08-29T00:00:00+00:00

Добрый вечер!

29 августа 1997 года компьютерная система Скайнет вышла из-под контроля и нанесла ядерный удар по России. Так началась война между терминаторами и человечеством.

С тех прошло 24 года, с ума сойти! Мы живём в будущем! И пока ещё мы управляем компьютерами.

Я каждый год отмечаю этот день, и сегодня в честь праздника мы зарелизили Selenide 5.24.0.

Добавили метод `$.execute(Command, Duration)`

для запуска самопальных команд с заданным таймаутом.

В Selenide 5.3.0 мы добавили возможность легко запускать самопальные команды с помощью метода $.execute(). Но тогда не было возможности задать кастомный таймаут. Теперь можно.

См. issue 1525.
Спасибо Evgenii Plugatar за PR 1531

Методы `$.execute(Command)` и `$.execute(Command, Duration)` больше не передают параметры заданной команде

Это мелочь, но теоретически может сломать ваши самопальные команды, если они у вас есть. Будьте начеку.

См. issue 1527.
Спасибо Evgenii Plugatar за PR 1535

Исправили условия `Or` и `And` при работе с несуществующими элементами

См. issue 1534.
Спасибо Evgenii Plugatar за PR 1539

Теперь условия `Or` и `And` не позволяют передать пустой список условий

Надеюсь, вы и не пытались, потому что это лишено смысла. Но если раньше Селенид это позволял и тесты могли быть ложно зелёными, то теперь вы словите ошибку в рантайме.
Спасибо Evgenii Plugatar за PR 1542

Переименовали методы `Condition.applyNull()` и `CollectionCondition.applyNull()`

Когда-то по молодости я назвал этот метод applyNull, но это название вводит в заблуждение. Этот метод говорит о том, выполняется ли условие, если искомый элемент вообще не найден, и теперь он называется missingElementSatisfiesCondition() - длинновато, зато точно.

См. issue 1541.
Спасибо Evgenii Plugatar за PR 1544

Убрали из логов длинные бесполезные стектрейсы при закрытии вебдрайвера

Как вы знаете, Селенид сам закрывает вебдрайвер в тот момент, когда он больше не нужен.
Для этого Селенид запускает всякие хитрые потоки, которые в фоновом режиме следят со состоянием всех открытых вебдрайверов.
И когда наступает момент, закрывают ненужные.

Но так бывает, что к моменту закрытия вебдрайвера его уже успел закрыть какой-то другой поток. И тогда Селенид мог плеваться в лог длинными страшными стектрейсами. Это не опасно, но никто ведь не любит спам.

В общем, теперь Селенид немного сократил объём спама. :)

См. issue 1467 и PR 1540

Исправили поиск shadow root внутри веб-элементов

См. issue 1532 и PR 1536

selenide-selenoid 1.1.5

Мы выпустили selenide-selenoid:1.1.5 с обновлением на Selenide 5.24.0

selenide-appium 1.6.8

Мы выпустили selenide-appium:1.6.8 с обновлением на Selenide 5.24.0

UPD: Selenide 5.24.1

WebDriverManager - это библиотека (которую Селенид использует под капотом) для скачивания бинарников вебдрайвера. Недавно они выпустили большое обновление 5.0.0 с кучей новых фич. Возможно, мы захотим использовать какие-то из этих фич в Селениде, но пока что мы по-быстрому выпустили Selenide 5.24.1 с обновлением на WebDriverManager 5.0.1.

Спасибо Anil Kumar Reddy Gaddam за PR 1531.

UPD: Selenide 5.24.2

Оказалось, что зависимость commons-lang3 (которую Селенид используем под капотом) больше прилетает транзитивно из WDM 5.x. А раньше прилетала из WDM 4.x. Поэтому нам пришлось по-быстрому добавить явную зависимость commons-lang3 и зарелизить Selenide 5.24.2.

См. issue 1551.

UPD: Selenide 5.24.3

Обновились на WebDriverManager 5.0.2, теперь смогли исключить docker-java и некоторые другие лишние зависимости.

UPD: Selenide 5.24.4

Обновились на WebDriverManager 5.0.3, в котором вышел срочный фикс для нового Firefox 92.0 на маке. И кое-что ещё по мелочам.

Ссылки

Новое шоу Айтишники от Артёма и Севы
Оказывается, на Селениде можно писать тесты не только для веб и мобилок, но и для Swing приложений! Вот пример. Под капотом он использует реализацию вебдрайвера для swing.
Сильно спорный доклад, но есть полезные идеи: SPA. React. Selenium vs. Selenide
5-7 октября снова будет Гейзенбаг - подавайте заявки!

Статистика использования Селенида

249+ тысяч скачиваний в месяц. Чуть-чуть не хватило до 250K.

Аста ли виста, бэйби!

Андрей Солнцев

ru.selenide.org

Вышла Selenide 5.23.0

2021-07-16T00:00:00+00:00

Добрый вечер!

16 июля вышел релиз Selenide 5.23.0.

В нём появилось кое-что существенно новое для селенида.

Проверки нового поколения

Теперь в селениде есть встроенные проверки не только для веб-элементов, но и для некоторых других штук. С автоматическими ожиданиями, понятными сообщениями об ошибках, попаданием в отчёт и т.д. Всё как вы любите.

См. issue 1442. Спасибо Dmitriy Budim за запуск всей этой эпопеи в PR 1478.

Давайте посмотрим, что же это за проверки.

Проверки для URL

До сих пор в селениде было только два метода, позволяющие получить URL текущей страницы или текущего фрейма (в большинстве случаев это одно и то же).

  String url1 = WebDriverRunner.url();
  String url2 = WebDriverRunner.currentFrameUrl();

Как их проверять, было непонятно. И ещё непонятнее, как дождаться, что нужный урл загрузился.

Теперь такие проверки есть:

import static com.codeborne.selenide.Selenide.webdriver;
import static com.codeborne.selenide.WebDriverConditions.*;

webdriver().shouldHave(url("https://auth.google.com"));
webdriver().shouldHave(url("https://mastercard.ee"), Duration.ofSeconds(42));
webdriver().shouldNotHave(url("http://yandex.ru");
webdriver().shouldNotHave(urlStartingWith("ftp://"));
webdriver().shouldHave(currentFrameUrl(baseUrl + "/login.html"));
webdriver().shouldHave(currentFrameUrlStartingWith(baseUrl + "/logout.html"));

Каждая из этих проверок:

если надо, подождёт (по умолчанию до 4 секунд)
добавится в отчёт (текстовой или аллюр)
если урл по истечении 4 секунд не такой - сделает скриншот и кинет ошибку ConditionNotMetException

В лучших традициях селенида можно

переопределять дефалтовый таймаут (4 секунды) на любой другой: Configuration.timeout = 8000;
задавать кастомный таймаут (вторым параметром типа Duration.ofSeconds(42))
создавать свои кастомные проверки (см. пример)

Проверки для буфера обмена

Начиная с версии 5.20.0, в селениде есть метод для доступа к буферу обмена:

Clipboard clipboard = Selenide.clipboard();

Но если раньше можно было только засунуть и высунуть текст из буфера:

String foo = clipboard().getText();
clipboard().setText("bar");

То теперь его можно проверить - с дефалтовым и кастомным таймаутом, скриншотами и т.д.

clipboard().shouldHave(content("Hello fast World"));
clipboard().shouldHave(content("Hello slow World"), Duration.ofMillis(1500));

См. PR 1507

Проверки для `localStorage`

Начиная с версии 5.15.0, в селениде есть метод localStorage(), возвращающий объект LocalStorage.
Но у него были только методы getItem и setItem. Опять же, как их проверять и как дождаться нужного значения, было неясно.

Теперь ясно:

localStorage().shouldHave(item("cat”));
localStorage().shouldHave(itemWithValue("mouse", "Jerry”));

Кстати, заодно появился метод localStorage.getItems(), возвращающий всё содержимое в виде мапы.

См. PR 1502

Проверки для `sessionStorage`

Всё то же самое, что и про localStorage - добавились методы

sessionStorage().shouldHave(item("cat”));
sessionStorage().shouldHave(itemWithValue("mouse", "Jerry”));
Map<String, String> items = sessionStorage.getItems();

См. PR 1502

Небольшой рефакторинг

Мы сделали классы StaticConfig и StaticDriver непубличными.
Нам кажется, они никому не должны быть нужны вне селенида. А в ваших проектах они используются? Пишите нам, если у вас развалилась компиляция. :)

И небольшой багфикс:

Теперь метод Selenide.screenshot("filename") снова делает скриншот, даже если настройка Configuration.screenshots выставлена в false.

Давайте проясним.

Настройку Configuration.screenshots стоит прописать в false, если вам не хочется, чтобы селенид автоматически создавал скриншоты при падении тестов. Често говоря, не понимаю, в каких ситуациях это может быть полезно.
А вот метод Selenide.screenshot("filename") можно вызвать в любой момент теста, чтобы явно сделать скриншот, независимо от того, упал тест или не упал. Тоже не очень понимаю, в каких ситуациях это может быть полезно.

Но суть в том, что второй метод работает независимо от первой настройки. Теперь можно выключить автоматические скриншоты, но дёргать их руками только там, где надо.

См. issue 1477 и PR 1506

selenide-selenoid 1.1.4

Мы выпустили selenide-selenoid:1.1.4 с обновлением на Selenide 5.23.0

selenide-appium 1.6.7

Мы выпустили selenide-appium:1.6.7 с обновлением на Selenide 5.23.0

Ссылки

Статья Selenium или Selenide? в корпоративном блоге “Прикладные Технологии”
Статья Selenide – UI tests in minutes от Anil Kulkarni

Статистика

232+ тысяч скачиваний в месяц.

Беззаботного лета!

Андрей Солнцев

ru.selenide.org

Вышла Selenide 5.22.3

2021-07-05T00:00:00+00:00

Добрый вечер!

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

Просто обновляйтесь на Selenide 5.22.3 с самыми свежими и вкусными багфиксами.

5.22.3 (released 05.07.2021)

#1474 add workaround for NPE in RemoteWebElement.isDisplayed() – see PR #1498

5.22.2 (released 30.06.2021)

#1493 support uploading files from inside of JAR files – see PR #1494
fix command ./gradlew - now it installs jars to a local maven repo – see PR #1489
add support for okhttp 4.9.1 – see PR #1488

5.22.1 (released 18.06.2021)

Add mime type “binary/octet-stream” to download binary files in FireFox

Беззаботного лета!

Андрей Солнцев

ru.selenide.org

Вышла Selenide 5.22.0

2021-06-08T00:00:00+00:00

Добрый вечер!

Лучший подарок - сделанный своими коммитами.
В мой день 40 рождения мы выпустили юбилейный релиз Selenide 5.22.0.

Развернём упаковку?

Теперь можно закрыть алерт перед скачиванием файла

В Селениде есть метод $.download(), который работает по простому принципу:

Кликни.
Подожди, пока в папке появится нужный файл.

Проблема в том, что на некоторых сайтах после клика появляется алерт, который нужно закрыть, чтобы началось скачивание. Ну или вообще, нужно совершить ещё какое-то действие после или вместо клика, чтобы запустить скачивание файла.

Теперь можно будет закрыть алерт:

File downloadedFile = $(byText("Download me with alert")).download(
      using(FOLDER).withAction(
        clickAndConfirm("Are you sure to download it?")
      )
    );

или вообще совершить любое нужное действие:

File downloadedFile = $(byText("Download me with alert")).download(
    using(PROXY).withAction((driver, link) -> {
      // add cookies
      link.click();
      // driver.switchTo().window();
      // alert.dismiss();
      // send http request
      // call api
    }));

См. issue 1479 и PR 1481.

Доработали проверку `Condition.textCaseSensitive`

… чтобы она поддерживала выбранные опции в <select> - по аналогии с Condition.text.

Спасибо Oleg Berezhnoy за PR 1482.

Добавили селекторы `byTextCaseInsensitive` и `withTextCaseInsensitive`

… для поиска элемента по тексту, игнорируя регистр.

Было

В селениде давно есть методы для поиска по тексту.

по полному тексту: $(byText("Wake up we have a tsar again")
по подстроке: $(withText("we have a tsar")

Эти селекторы чувствительны к регистру (и внутри используют XPath 1.0).

Стало

Теперь же мы добавили аналогичные методы, но нечувствительные к регистру:

$(byTextCaseInsensitive("wake UP we have a TSAR again")
$(withTextCaseInsensitive("TSAR agAiN")

Эти селекторы позволяют искать элементы, игнорируя большие-маленькие буквы.

Технический нюанс

этот функционал не получилось реализовать с помощью XPath, потому что строковые функции типа lower-case и match появились лишь с версии XPath 2.0, а все современные браузеры поддерживают только XPath 1.0. Поэтому пришлось наколбасить хитрый JS код для обхода всего дерева элементов.

См. issue 1380 и PR 1381.

Добавили метод `Driver.getSessionId()`

По сути он нужен для интеграции с Selenoid.

Спасибо Petro Ovcharenko за PR 1483.

Уменьшили селенимовские таймауты

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

Соединение с вебдрайвером: connectTimeout = 120000 ms = 2 минуты
Запрос к вебдрайверу: readTimeout = 10800000 ms = 3 часа (!)

Если какая-то операция с вебдрайвером подвисает, то ваш тест будет висеть 3 часа. Ну это же ненормально!
Например, так происходит, когда тестируется приложение на Electron, и оно уходит в трей, а тест пытается сделать скриншот - и надолго зависает.

В Selenide 5.22.0 мы добавили возможность менять этот таймаут (под капотом используется жёсткий рефлекшин).
И да, мы сделали дефалтовые значения чуть поменьше (хоть и по-прежнему слишком консервативные):

connectTimeout = 1 минута
readTimeout = 2 минуты

Давайте восприниматься это как костыль и надеяться, что в Selenium 4 появится более правильное решение.

См. PR 1433.

selenide-selenoid 1.1.3

Мы выпустили обновление selenide-selenoid:1.1.3, в котором исправили ClassCastException в некоторых случаях.

Спасибо Petro Ovcharenko за PR 10.

selenide-appium 1.6.6

Мы выпустили обновление selenide-appium:1.6.6, в котором обновились на Selenide 5.22.0

Ссылки

Ого-го! Сразу несколько известных ребят выложили свои видосики про Селенид.

Java champion Sebastian Daschner: Why I switched to using Selenide for UI tests
JetBrains feat. DJ Юрий Артамонов: Modern UI Test Automation with Selenium Libraries
Статья от JetBrains про этот стрим

И ещё всплыла парочка старых материалов:

Сергей Брит Selenide. Tips and tricks, slides
Selenide review by Provectus

И на десерт - молодое поколение учит Селенид:

Андрей Солнцев

ru.selenide.org

Вышла Selenide 5.21.0

2021-05-15T00:00:00+00:00

Добрый вечер!

За окошком месяц май, а на экране релиз Selenide 5.21.0.

Убрали повторные скриншоты и шаги в отчёте для цепочи локаторов

Большинство методов Селенида устроены так, что их можно вызвать несколько штук подряд, в одну строку. Это позволяет писать лаконичные тесты.

Что-то вроде

  $("table#id").$("tbody", 2).$("tr.active").$("td", 5)
    .shouldHave(text("Ну вот"))
    .click();

Правда, с ними была одна проблема. При падении такой проверки Селенид делал несколько скриншотов, а в отчёт (в т.ч. числе в аллюровский отчёт) добавлялось несколько шагов (один для "table#id", второй для "tbody" и т.д.), хотя по сути это один шаг.

Хоть это и некритично, мы эту неприятность убрали. Теперь селенид будет делать один скриншот, а в аллюр отчёте будет одна строка.

См. issue 1055 и PR 1465.

NB! Для этого пришлось сделать приличный рефакторинг, и не исключено даже, что что-то могло сломаться. Сообщайте, будем реагировать!

Добавили BrowserPerTestStrategyExtension

… для перезапуска браузер после каждого теста.

По умолчанию Селенид переиспользует браузер между тестами (в рамках одного потока). Это сделано для скорости. Мы предполагаем, что вы сами в начале теста позаботитьесь о том, чтобы обновить страницу, почистить данные и т.п. - ведь это зависит от каждого приложения.

Если же вы очень хотите в каждом тесте использовать новый браузер, есть и такая возможность. В Селениде из коробки есть поддерджка для JUnit 4, JUnit 5 и TestNG.

Но для JUnit5 у нас был только экстеншн для перезапуска браузера для каждого тестового класса (@ExtendWith({BrowserStrategyExtension.class}), но не тестового метода.

А теперь появился экстенш, заполнивший эту нишу. Если прописать в ваших тестах @ExtendWith({BrowserPerTestStrategyExtension.class}, то в каждом тестовом методе будет использоваться новый браузер.

Это сделает ваши тесты значительно медленнее, но иногда по-другому никак.

См. issue 1448 Спасибо Anton Aftakhov за PR 1450.

Добавили метод $.hover() со сдвигом

В селениде давно есть метод $("div#123").hover() для наведения курсора мыши на нужный элемент. Этот метод двигает курсор к центру элемента, и на это не было возможности повлиять.

Теперь же у нас появился метод $.hover() с параметром, позволяющим указать, на сколько пикселей от центра нужно сдвинуть курсор:

  $("div#123").hover(withOffset(123, 122));

P.S. Кажется, этот сдвиг не всегда оказывается точным. У меня иногда курсор оказывался примерно в этой позиции плюс-минус 30 пикселей. Делитесь, как у вас?

См. issue 1447 и PR 1461.

Обновились на WebDriverManager 4.4.3

Спасибо Anil Kumar Reddy Gaddam за PR 1464 и PR 1469.

Обновились javadoc многих селенидовских методов

… касающийся ленивой загрузки и фразы “not recommended”.

Теперь javadoc ведёт на эти две статьи в вики:

Внимание, неоднозначный контент.
Возможно, вы захотите подискутировать.
Так давайте подискутируем!

См. PR 1430

selenide-selenoid 1.1.2

Мы выпустили обновление selenide-selenoid:1.1.2, в котором добавили поддержку BasicAuth при скачивании файлов из контейнера Selenoid.
См. issue 8 и PR 9.

selenide-appium 1.6.5

Мы выпустили обновление selenide-appium:1.6.5, в котором улучшили сообщения об ошибках пр падении тестов в iOS.
См. issue 54.

Ссылки

Что новенького мы нарыли на просторах сети:

Открытые видеокурсы Дневник тестировщика - там и про селенид есть несколько выпусков.
Как e2e автотесты на Selenide помогают QA-команде при частых релизах
годный тред как слезть с ЛКФ на Селенид (ЛКФ = локальный кривой фреймворк)
Пост Write Concise Web Tests With Selenide for Java Projects за авторством Philip Riecks.
Видео Введение в Selenide от него же
Маленький видеоурок Create Screenshots With Selenide от него же
Пример Selenide+Serenity+JBehave
Пример Selenide+TestNG+ExtentReports
курс Selenium и Selenide для начинающих (прикольно же!)

Немного статистики

Статистика скачиваний Selenide за апрель 2021:

Чуть-чуть не дотянули до 200 тысяч.

Андрей Солнцев

ru.selenide.org

Вышла Selenide 5.20.1

2021-03-23T00:00:00+00:00

Добрый вечер!

Джо Байдена спросили, считает ли он $$.as киллер-фичей. «Ммм, хмм, да», — ответил Байден.

Это сдвоенный обзор на релиз Selenide 5.20.0 и Selenide 5.20.1.

Добавили методы для операций с буфером обмена

Selenide.clipboard().setText("111");
assertEquals("Hello World", Selenide.clipboard().getText());

Имейте в виду, что на линуксе буфер обмена не будет работать без иксов. Либо запускайте xvfb, либо ещё как-то выкручивайтесь.

Спасибо Dmitriy Budim за PR 1409.

NB! Эти методы переопределены в плагине selenide-selenoid, так что они корректно работают с селеноидом. Для него мы тоже выпустили версию 1.1.0.

Добавили режим headless для браузера Microsoft Edge

Раньше настройка Configuration.headless срабатывала только для Chrome и Firefox, а теперь ещё и для Edge.

(Браузеры IE, Opera и Safari, насколько я знаю, до сих пор не поддерживают headless режим.)

См. issue 1422 и PR 1424.

Добавили метод $$.as() для задания алиаса коллекциям

Как вы помните, в Selenide 5.17.0 мы добавили возможность задавать единичным элементам “понятное” имя. Теперь имя можно задавать и коллекциям:

$(By.xpath("/long/ugly/xpath[1][2][3]")).as("Login button").shouldBe(visible);
$$(By.xpath("/long/ugly/xpath[1][2][3]")).as("Login buttons").shouldHave(size(2));

См. issue 1389 и PR 1431.

NB! Не торопитесь использовать эту возможность. Лично я воспринимаю её как “хак последней надежды”.
В отчёте всегда лучше видеть настоящий локатор, чем кем-то придуманное имя, которое всегда может оказаться:

Обманчивым
Устаревшим
Вводящим в заблуждение

Лучше инвестируйте свои усилия в то, чтобы использовать читаемые локаторы. Ну и грамотно называть переменные и методы. Вот где сила, брат!

Добавили проверку для коллекций `containExactTextsCaseSensitive`

Существующий метод $$.shouldHave(texts("a", "b", "c")) проверяет, что в коллекции ровно эти элементы и никаких больше. А иногда хочется менее строгой проверки. Например, нужно проверить, что в списке торгуемых валют точно есть RUB, EUR, USD - и какие угодно ещё.

Теперь для этого есть метод:

  $$.should(containTexts("RUB", "EUR", "USD"));

Спасибо Oleg Berezhnoy за PR 1426.

UPD В оперативно вышедшей Selenide 5.20.1 его переименовали в

  $$.should(containExactTextsCaseSensitive("RUB", "EUR", "USD"));

Спасибо Oleg Berezhnoy за PR 1438 и PR 1439.

Починили утерянные опции FirefoxOptions

В некоторых ситуации некоторые настройки Firefox терялись, теперь не теряются. Опции нашлись.

См. issue 1436. Спасибо Dmitriy Budim за PR 1437.

Убрали логирование “поисковых” методов

В SelenideElement есть несколько методов для поиска других элементов:

$.findAll()
$.parent()
$.sibling()
$.preceding()
$.lastChild()
$.closest()

Такие методы оказывались в отчёте дважды: сначала при их вызове, а потом - при вызове любого метода на найденном элементе. Теперь мы это дублирование убрали.

Спасибо Pavel Fokin за PR 1428.

Доска объявлений

Ура, новый сезон конференций открыт! Буквально через неделю-две начинается:

У кого нет денег на Heisenbug и JPoint - приходите 27 марта на бесплатный фестиваль TechTrain, программа там очень многообещающая.
- Я, например, планирую послушать “Что мобильным разработчикам в IT-индустрии неведомо”
- и “Ловушки коллективного владения кодом”.
- И конечно, “Какие тулы ты бы взял на удаленку” от ведущих “Ошибки выжившего” Севы и Артёма обещает стать хитом.
А 6-9 апреля грядёт наш любимый Heisenbug.

У меня там будет заключительный доклад эпопеи про флейки тесты “Flaky tests. Метод” и продолжение мастер-класса “Как начать свой проект автоматизации с нуля”.

А послушать я хочу как минимум мастер-класс гуру юзабилити Виталия Фридмана “От birthday selector до inline validation: Всё, что нужно знать о веб-формах” и много чего ещё вкусненького.
А 13-17 апреля пройдёт конференция JPoint

Она скорее для разработчиков, и на ней я тоже успею засветиться в мастер-классе по парному программированию.
А ещё 29 мая будет новосибирский Codefest

Там у меня будет доклад про “Трюки с javascript в автотестах”.

Приходите, всё равно ж делать нечего на карантине!

Андрей Солнцев

ru.selenide.org

Вышла Selenide 5.19.0

2021-02-24T00:00:00+00:00

Всем привет!

Вы, наверное, не знали, но сегодня, 24 февраля, в Эстонии чуть ли не главный праздник - День Независимости. Ровно 103 года назад Эстония была провозглашена независимым демократическим государством.

А спустя 93 года в Эстонии, в казематах компании Codeborne родилась библиотека Selenide. Это ли не чудо?

Дню независимости мы и посвящаем наш новый релиз Selenide 5.19.0.

Наконец-таки починили drag’and’drop

В селениде уже давно есть метод $.dragAndDropTo(), но он фактически не работает. Под капотом он использует селениумовский механизм Actions, и что-то там явно сломано. Ну не тащит элемент и всё.

А теперь мы запилили альтернативную реализацию с помощью JavaScript. И она, похоже, работает во всех браузерах. Поэтому мы даже включили её по умолчанию.

// Рабочий вариант:
$("#drag1").dragAndDropTo("#div2");
$("#drag1").dragAndDropTo("#div2", usingJavaScript());

// Нерабочий вариант через Actions (ну вдруг он у вас почему-то работает):
$("#drag1").dragAndDropTo("#div2", usingActions());

См. issue 1110.

Спасибо Dmitriy Budim за PR 1412.

Поддержка Appium

Заодно мы выпустили и обновление библиотеки selenide-appium:1.6.2, в которой метод $.dragAndDropTo(), теперь переопределён, так что он работает и на мобильниках. См. PR #53.

Починили метод `$.click(usingJavascript())` в Internet Explorer

См. issue 1406 и PR 1419.

Улучшили описание коллекции `$$.snapshot()`

У селенидовских коллекций есть один хитрый метод $$.snapshot(). Он запоминает текущее состоние коллекции, и при дальнейших обращениях не загружает её заново из браузера. Это полезно для ускорения тестов, когда коллекция большая, и вы уверены, что её элементы уже точно не изменятся.

С ними была только маленькая проблемка: в отчётах выглядело не слишком красиво. Например, такая строка:

$$("#root li").snapshot().shouldHave(size(3))

при падении в отчёте выглядела как

List size mismatch: expected: = 3, actual: 2, collection: $$(2 elements)

Как видите, в описании нет селектора оригинальной коллекции, только (2 elements).

Теперь виден и селектор:

List size mismatch: expected: = 3, actual: 2, collection: #root li.snapshot(2 elements)

Спасибо Pavel Fokin за PR 1402.

Добавили метод `$.getAlias()`

Он возвращает то, что вы сами же задали с помощью $.as("login button"). В обычных тестах этот метод не должен быть нужен. Но может понадобиться, если вы пилите какой-то свой хитрый отчёт. Ну мало ли, убийцу Аллюра…

Спасибо pavelpp за PR 1415.

Добавили события “refresh” и т.п. в селенидовский лог

В селениде есть целый ряд методов, которые не связаны явно в веб-элементами (refresh(), back() и т.п.) И мы в какой-то момент обнаружили, что некоторые из них не отображались в отчёта Selenide или Allure. Несмертельно, конечно, но всё-таки зачем-то ведь эти отчёты кому-то нужны…

Теперь мы исправили эту оплошность, и следующие методы будут исправно красоваться в отчётах:

refresh
back
forward
updateHash
confirm
dismiss
prompt
clearCookies

См. issue 1383 и PR 1404.

Добавили аннотаций `@Nullable` методам класса `WebDriverRunner`

Самым важным, по-видимому, тут является метод WebDriverRunner.getSelenideProxy() - не было очевидно, что он может возвращать null, если прокси не запущен.

Теперь такая ошибка будет подсвечиваться в IDE жёлтеньким.

См. коммит.

Починили тесты селенида на не-англоязычных машинах

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

Теперь тесты исправлены, и по идее такое больше не может повториться.

Спасибо Vicente Rossello Jaume за PR 1408.

Статистика

Свежая статистика по скачкам Селенида:

Традиции

Ну вот и всё на сегодня.

Вы обновляйтесь, а я пока пойду найду стопки водки и бутерброд с килькой. Традиция, ничего не поделаешь.

Андрей Солнцев

ru.selenide.org

Вышла Selenide 5.18.1

2021-02-11T00:00:00+00:00

Всем привет!

Как сказал бы рэпер Гнойный, “релизай, а не накапливай!”
Вот и мы релизнули небольшое обновление Selenide 5.18.1.

Давайте заглянем туда с фонариком:

Добавили метод `Selenide.getSessionStorage()`

по аналогии с Selenide.getLocalStorage(), который появился ранее в версии 5.15.0.

У них одинаковый набор методов: getItem, setItem, removeItem, clear и т.д.

Иногда полезно положить sessionStorage или localStorage, скажем, хитрый флаг, чтобы эмулировать какое-нибудь действие пользователя или включить-выключить какие-то фичи или настройки.

Спасибо Dmitriy Budim за PR 1400.

P.S. Для справки, разница между localStorage и sessionStorage.

Исправили сообщение об ошибке для `$$.filterBy(and(..))`

Как вы знаете, селенид предоставляет богатые возможности для фильтрации и проверки коллекций.

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

$$(".sofa").filterBy(and("shining", text("Jorshik"), text("Zoloto"))).shouldHave(size(2));

Результат был не совсем логичный (он содержал лишь последнее проверенное условие):

... collection: .sofa.filter(text Jorshik)

А теперь результат более корректный (он содержит все условия):

... collection: .sofa.filter(shining: text 'Jorshik' and text 'Zoloto')

См. issue 1392.
Спасибо Pavel Fokin за PR 1393.

Передаём настройку “noproxy” от внешнего прокси селенидовскому

Бывает, что селенид запускается и со своим собственным прокси, и с прокси пользователя.

У прокси есть одна особенная настройка “noproxy”, и туда часто пихают “localhost”. Это значит, что через прокси должны ходить все запросы, кроме “http://localhost:*”. Так вот, в случае с “двойным” прокси эта настройка терялась, и селенид не мог выполнить запросы на localhost.

Напрямую, а не через прокси.

Локалхост - нежная штучка!

Спасибо Boris Osipov за PR 1390.

Обновились на Netty 4.1.59.Final и LittleProxy 2.0.2

Вряд ли вы будете читать, но вот релизноутсы Netty 4.1.59.Final и LittleProxy 2.0.2. Как минимум там исправили какие-то утечки памяти и дыру в безопасности.

Читальня

Организаторы Гейзенбага выложили видосики с осеннего Heisenbug Moscow 2020.
Из того, что я успел заметить:

Flaky tests. Порядок имеет значение / Андрей Солнцев
Воркшоп “Как начать свой проект автоматизации с нуля”: часть 1, часть 2 / Андрей Солнцев, Юрий Артамонов
Серверный античит: Панацея или рудимент? / Евгений Ченцов, Евгений Крутских
Типы автоматического тестирования в IntelliJ IDEA / Юрий Артамонов
Тест-кейсы как код / Артем Ерошенко

Вот и всё на сегодня. Обновляйтесь и делитесь впечатлениями. Заводите баги на гитхабе, жалуйтесь в чатиках, материтесь в твиттере.

Опенсорс сильнее багов!

Андрей Солнцев

ru.selenide.org

Вышла Selenide 5.18.0

2021-01-23T00:00:00+00:00

Ура, товарищи!

На дворе 23 января.

Несанкционированные релизы сейчас запрещены, поэтому сегодня у нас просто негативное падение номера версии. Обновляйтесь: Selenide 5.18.0.

Приглашаю вас на маленькую виртуальную экскурсию по изменениям в 5.18.0.
Устраивайтесь поудобнее.

Выключили логи вебдрайвера по умолчанию

Начиная с версии 5.13.0, Selenide писал логи вебдрайвера в файлы build/reports/tests/webdriver.uuid.log.
Тогда это казалось полезным, но оказалось, что логи эти занимают довольно много места и особо никого не интересуют. Поэтому мы всё-таки решили не включать их по умолчанию.

Логи вебдрайвера отправляются в комнату для мусора.

Если надо, вы всегда можете включить эти логи настройкой
Configuration.webdriverLogsEnabled = true.

См. issue 1365 и PR 1379.

Заменили тип параметра “timeout” с Long на Duration

… в методах коллекций. Теперь вместо

$$.shouldHave(texts(...), 5000);

модно будет писать

$$.shouldHave(texts(...), Duration.ofSeconds(5));

См. issue 1377.
Спасибо Ostap Oleksyn за PR 1377.

Ускорили поиск вложенных элементов в shadow dom

Одна из фич, которые есть Selenide, но нет в Selenium webdriver - это shadow dom:

$(shadowCss("p", "#shadow-host", "#inner-shadow-host"))
    .shouldHave(text("The Shadow-DOM inside another shadow tree"));

В дереве DOM может быть сколько угодно shadow root внутри других shadow root.

Чтобы найти все элементы внутри всех вложенных shadow root, метод $(shadowCss()) вызывал в цикле
хитрый JavaScript код для каждого shadow root по отдельности. И это может быть медленно, потому что каждый вызов webdriver занимает время.

Теперь $(shadowCss()) дёргает ещё более хитрый рекурсивный JavaScript, который находит все элементы во всех shadow dom за один вызов.

См. PR 1373.

Отдельное спасибо sakamoto66 за issue 1246 и PR 1233. К сожалению, он не был влит, но дал нам пищу для размышлений.

Исправили проверки `$.shouldNot(and(...))` и `$.shouldNot(or(...))`

Пользователь pavelpp обнаружил в селениде багу, комбинируя not с условиями and и or:

$(".lolkek").shouldNotBe(visible, ofSeconds(5));   // работает
$(".lolkek").shouldNotBe(and("foo", visible));     // падает
$(".lolkek").shouldNotBe(or("foo", visible));      // падает

Не отвертишься. Пришлось чинить.

См. issue 1369 и PR 1370.

Кстати, мы запретили and и or только с одним условием. То есть теперь строка or("foo", visible) не скомпилируется. Придётся написать как минимум два условия: or("foo", visible, enabled).

Согласитесь, это логично. Зачем нам выбор из одного?

Обнаруживаем конфликт в настройке “browserName”

Так уж вышло, что для задания браузера есть две разных настройки:

Главная - Configuration.browser
Другая - Configuration.browserCapabilities["browserName"] (не знаю, зачем она вообще нужна)

И у вас может открыться неожиданный браузер, если вы не задали первую, но задали вторую. В общем, теперь селенид обнаруживает такой конфликт и сразу кидает ошибку, чтобы всем всё стало понятно:

IllegalArgumentException: Conflicting browser name: 'chrome' vs. 'firefox'

Подчёркиваю: настройки Configuration.browser должно хватать во всех случаях, поэтому вторую не надо никуда пихать.

См. issue 1366 и PR 1374.

Починили показ таймаута в отчёте

Недавно мы добавили в методы $.should* параметр timeout с типом Duration. А потом оказалось, что он непонятно отображался в отчётах.
Например, строка $("h1").shouldBe(visible, Duration.ofSeconds(1)) в отчёте выглядела так:

$("h1") should be([visible, PT1M])

И хотя эта “PT1M” на самом деле отвечает стандарту ISO и означает “time period 1 minute”, мы всё же заменили её на более понятные “300 ms”, “1s”, “1.500 s.” и т.п.

См. issue 1376 и PR 1378.

Обновились на WebDriverManager 4.3.1

Как обычно, изменения описаны здесь.

Читальня

На хабре вышла расшифровка доклада “Как законтрибьютить в опенсорс, чтобы не сгореть со стыда” со смачной картинкой Мастера Йоды. Этот доклад мы с Артёмом Ерошенко делали на фестивале TechTrain осенью 2020.

По ссылке и текст, и видео: кому что больше нравится.

Буду счастлив, если пользователи Селенида его посмотрят. Вы же хотите приобщиться к таинству опен-сорса?

Всем щастья!

Андрей Солнцев

ru.selenide.org

Вышла Selenide 5.17.2

2020-12-30T00:00:00+00:00

Доброе утро!
Гномики всё никак не успокоятся. Завтра утром они принесут в ваши носочки последний подарочек: релиз Selenide 5.17.2.

Теперь `Commands` возвращают `SelenideElement` вместо `WebElement`

Это даёт возможность чейнить вызовы методов $.execute(Command) с другими селенидовскими метода, делая ваши тесты ещё лаконичнее и экспрессивнее:

$(".lupa").execute(new ScrollToCenter()).$(".pupa").click();

Спасибо Boris Osipov за PR 1355.

Починили метод `$.setValue(null)`

См. issue 1356. Спасибо Dmitriy Zemlyanitsyn за PR 1357.

Включили soft asserts в методах @BeforeAll и @AfterAll (в JUnit 5)

См. issue 981, issue 1070 и PR 1359.

Починили файл selenide-5.17.2-javadoc.jar

теперь он содержит javadoc для всех классов.

Ещё раз с наступающим!

Андрей Солнцев

ru.selenide.org

Вышла Selenide 5.17.0

2020-12-26T00:00:00+00:00

Доброй ночи!

Я трепетно отношусь к Католическому Рождеству.
Потому, что именно в Рождество террористы захватили небоскрёб Накатоми, и Брюс замочил Ханса Грубера. А потом взорвал самолёт зажигалкой.

Поэтому ловите рождественский релиз Selenide 5.17.0.

Добавили метод $.as(“name”)

Чувствую, что открываю ящик пандоры, но что уж поделаешь…

В общем, мы добавили метод as, позволяющий давать элементам читаемые имена.

Чтобы продемонстрировать эффект, давайте сравним эти две строки в тесте:

  $(By.xpath("/long/ugly/xpath[1][2][3]")).shouldNot(exist);
  $(By.xpath("/long/ugly/xpath[1][2][3]")).as("Login button").shouldNot(exist);

Результат в отчёте будет таким:

  +---------------------------------------+--------------------+----------+----------+
  |Element                                |Subject             |Status    |ms.       |
  +---------------------------------------+--------------------+----------+----------+
  |By.xpath: /long/ugly/xpath[1][2][3]    |should not(exist)   |PASS      |13        |
  |Login button                           |should not(exist)   |PASS      |38        |
  +---------------------------------------+--------------------+----------+----------+

В последней строке вместо длинного нечитабельного xpath мы видим понятное имя “Login button”.

Обманчивым
Устаревшим
Вводящим в заблуждение

См. issue 1200 и PR 1353.

Добавили настроек нашему headless chrome

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

Спасибо Aliaksandr Rasolka за PR 1329.

P.S. Интересно, если ребята из puppeteer решать с крыши спрыгнуть, мы тоже спрыгнем?

Починили `ByShadowCss.findElements`

Оказалось, в одном хитром случае он возвращал не все элементы: когда в DOM было несколько inner shadow hosts (как это по-православному, бог ты мой?)

Теперь возвращает все.

См. issue 1346. Спасибо Daniel H. Peger за PR 1347.

Добавили метод $.should* с кастомным таймаутом

Как вы все знаете, в Селениде есть две основных группы методов:

$.shouldHave / $.shouldBe / $.should – используют таймаут по умолчанию
$.waitUntil / $.waitWhile – используют заданный таймаут

Методы $.wait* полезны для ожидания явно долгих действий, которые точно длятся дольше обычного таймаута (который 4 секунды по умолчанию).

Проблема с $.wait* методами чисто грамматическая: встроенные селенидовские проверки не звучат по-английски корректно с глаголом “wait”:

element should have text - звучит
element wait until text - не звучит

Не смертельно, но ухо режет (как говорил Ван Гог, гы-гы).

Поэтому теперь вы можете заменить $.waitUntil(hasText("bob"), 18_000) на $.shouldHave(text("bob"), Duration.ofSeconds(18)).

См. issue 1136, issue 1338 и PR 1340.

Пэдж обжекты

Следующий блок улучшений касается пэдж обжектов. Как вы знаете, в селениде есть возможность объявлять свои пэдж обжекты,

а в них объявлять поля с аннотациями @FindBy,
а поля эти могут быть как стандартные селениумовские WebElement,
так и наши SelenideElement,
и даже переиспользуемые компоненты ElementsContainer, из которых можно собирать пэдж обжекты, как из кирпичиков.

И работает всё это в лучших традициях селенида: ленивая загрузка и перезагрузка элементов, вот это всё.

В общем, в этих @FindBy уже давно были шероховатости:

не работала ленивая загрузка для полей ПО с типом List<ElementsContainer> (см. issue 282 и 482)
не поддерживались поля ПО с дженериками (см. issue 694)

И это было сложно исправить. Пришлось погрузиться в этот (старый) код и серьёзно его порефакторить. Пришлось напрячь мозги и применить все свои остатки былого абстрактного мышления.

Так что эти два пулреквеста - предмет моей гордости:

И напоследок пачка технологических улучшений:

разбили проект на подпроекты - см. PR 1348
исправили тесты селенида, зависящие от ОС - См. issue 1344 и PR 1345, спасибо Daniel H. Peger
подчистили код Plugins – спасибо Yuri Orlov за PR 1343
Обновились до browserup-proxy:2.1.2 и guava:30.1-jre
Добавили поддержку chrome 88, edge 89, opera 73

Известные проблемы:

файл selenide-5.17.0-javadoc.jar получился неполным: он содержит javadoc не для всех классов. Надеемся, никто не обидится. Исправим в версии 5.17.1.

Итоги

В общем, заканчиваем год на позитивной ноте:
провели серьёзный рефакторинг и исправили несколько старых болячек.
В новый год мы переходим всего с одним экраном в github issues вместо прежних двух.

И количество скачиваний селенида выросло за год с 102 до 167 тысяч.

С наступающим!

Андрей Солнцев

ru.selenide.org

Вышла Selenide 5.16.2

2020-11-25T00:00:00+00:00

Всем привет!

Мы выпустили релиз Selenide 5.16.2.

Нет, вы не подумайте, что в недавнем крупном релизе Selenide 5.16.0 была куча багов. Вовсе нет.

Данный релиз 5.16.2 - это исправление кучи старых мелких бажочков, просто сейчас дошли до них руки.

Итак, коротко:

Релиз 5.16.2 (вышел 25.11.2020)

#1332 return old click(int, int) command logic – thanks to Petro Ovcharenko for PR #1333
make SoftAssertsExtension thread-safe – thanks to @dtuchs for PR #1334
#1258 fix soft asserts with ParameterizedTest in jUnit5 – see PR #1328
#1293 don’t report “Element not found” in case of other errors – see PR #1326
#1290 don’t show unused page object fields in report – see PR #1327
upgrade to littleproxy:2.0.1 – see PR #1325

Релиз 5.16.1 (вышел 23.11.2020)

Тут было два исправления, чтобы хром можно было запускать с расширениями.

#1314 do not exclude “load-extension” switch if Chrome is opened with extensions – see PR #1324
#1315 support custom DriverFactory for running remote browsers – see PR #1324

Новости

Раз осталось место, поделюсь новенькими ссылками:

Пример от LambdaTest: selenide-testng-sample
Видосик про Селенид на португальском: Testes de Aceitação em Java com Selenide, Adriano Magalhães
Курс по Селениду где-то в Бразилии: Automação Web Descomplicada Com Selenide
Визуальное тестирование: Applitools+Selenide
Пример проекта: Getting started with applitools

Selenide 5.17.0 уже не за горами, не переключайтесь!

Андрей Солнцев

ru.selenide.org

Вышла Selenide 5.16.0

2020-11-20T00:00:00+00:00

Всем привет!

Мы выпустили релиз Selenide 5.16.0.

Плагины

В начале 2020 года на конференции SeleniumCamp я рассказывал про roadmap селенида. Одна из ключевых идей на этот год была создать в селениде возможность подключать сторонние плагины.

И вот этот день настал!

На данный момент доступно два плагина:

Расскажем о них в отдельных постах.

Вероятно, дальше стоит оформить в виде плагинов поддержку Allure, JUnit, TestNG, AShot.
Накидывайте ещё идеи!

См. issue #1051 и PR #1264, PR 1317 и PR 1321.

Сообщения об ошибках

Одна из основных обязанностей селенида - составлять подробные сообщения об ошибках в случае падения тестов.
Иногда в эти сообщения тоже закрадываются неточности в каких-то сложных случаях.
В этом релизе мы запилили целую пачку улучшений сообщений об ошибках:

Улучшили описание проверок AND и NOT

Нормальный способ устроить негативную проверку в селениде - метод shouldNotHave. А проверить несколько условий подряд - просто через запятую:

  $("#username").shouldNotHave(text("admin"));
  $("#username").shouldHave(text("____"), attribute("data-masked"));

Но есть ещё методы Condition.not и Condition.and для особых случаев: например, с их помощью можно определять составные условия, таким образом составляя целый DSL для ваших тестов.

  public class MyConditions {
    private static final Condition NONADMIN = not(text("admin"));
    private static final Condition MASKED = and("MASKED", text("___"), attribute("data-masked"));
  }

  public class MyTest {
    $("#username").shouldBe(MASKED);
    $("#username").shouldBe(NONADMIN);
  }

Оказалось, что оба эти методы выводили в отчёте неполную информацию:

  | #username |should be(MASKED)                  |PASS |
  | #username |should have(not text)              |PASS |

Проблема в том, что в нём не виден ожидаемый текст (“admin”) и другие условия.

Теперь мы эту проблему исправили, и при падении проверки вы увидите сообщение с текстом:

  | #username |should be(MASKED: text '___' and attribute data-masked)      |PASS |
  | #username |should have(not text 'admin')                                |PASS |

Спасибо Pavel Fokin за PR 1306 и PR 1306.

Добавили информацию о предках

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

  $("#user-table").$("thead").$("trrrr-chah-chah").shouldHave(text("Age"));

Но если такая проверка падает, в сообщении был виден только локатор дочернего элемента:

  Element not found {trrrr-chah-chah}

А теперь мы также добавили информацию и о родителях:

  Element not found {#user-table/thead/trrrr-chah-chah}

Спасибо Petro Ovcharenko за PR 1312.

Добавили актуальные текст для проверок `ownText` и `exactOwnText`

Как вы помните, в Selenide 5.15.0 мы добавили проверки ownText и exactOwnText:

  $("#child_div1").shouldHave(ownText("Sonar"));

Но и тут оказалось, что при падении такой проверки в сообщении не выводился, а какой же “свой текст” был на самом деле. Выводился только текст элемента с детьми:

  Element should have own text 'Sonar' {#child_div1}
  Element: '<div id="child_div1">Son</div>'

Теперь мы добавили строчку “Actual value” с собственным текстом элемента:

  Element should have own text 'Sonar' {#child_div1}
  Element: '<div id="child_div1">Son</div>'
  Actual value: Son

См. issue 1261 и PR 1294.

Кидаем правильную ошибку при загрузке несуществующего файла

Если вы пытались загрузить несуществующий файл:

  $("input[type='file']").uploadFile(new File("/foo/bar/xyz.pdf"));

То получали некорректную ошибку:

  Element not found {input[type='file']}
  ...
  Caused by: InvalidArgumentException: invalid argument: File not found : /foo/bar/xyz.pdf

Казалось бы, мелочь, но иногда это сбивало с толку.

Теперь мы это исправили, и вы получите сразу

  InvalidArgumentException: invalid argument: File not found : /foo/bar/xyz.pdf

См. issue 987 и PR 1301.

Корень проблемы в том, что в селенум не хватает отдельных классов ошибок для всех возможных нестандартных ситуаций, и простой WebDriverException может говорить как о ненайденном элементе, так и неверной кодировке в вводимой строке. См., например, issues 1293.

Плюс некоторые реализации вебдрайвера могут кидать какие-то нелогичные ошибки - например, IEDriver когда-то кидал Throwable вместо ElementNotFound.

Поэтому в своё время в селениде была принята консервативная стратегия: если не удалось определить тип ошибки точнее, по умолчанию считаем, что элемент не найден. А в “caused by” будут видны подробности.

Адекватно показываем ClickOptions в отчёте

Как вы помните, в Selenide 5.15.0 мы добавили удобные методы для клика со всевозможными опциями:

  $("#page").click(usingJavaScript().offset(123, 222));

И снова оказалось, что в отчёте такая строка выглядит некрасиво:

  | #page               |click(com.codeborne.selenide.ClickOptions@33617539)         |PASS |

Мы и это исправили, теперь строчка стала окейнее:

  | #page               |click(method: JS, offsetX: 123, offsetY: 222)               |PASS |

См. issue 1302 и PR 1303.

Другое

Добавили проверку `$$.shouldHave(exactTextsCaseSensitiveInAnyOrder(...))`

В селениде уже давно есть проверки для коллекций:

  $$(".employee").shouldHave(texts("вася", "петя", "катя"));            // case-insensitive, substring
  $$(".employee").shouldHave(textsInAnyOrder("вася", "катя", "петя"));  // case-insensitive, substring, any order
  $$(".employee").shouldHave(exactTexts("вася", "петя", "катя"));       // case-insensitive, full string match

И теперь к ним добавилась ещё одна - менее толерантная:

  // case-sensitive, full string match, any order
  $$(".employee").shouldHave(exactTextsCaseSensitiveInAnyOrder("Вася", "Петя", "Катя"));

Спасибо Vitali Plagov за PR 1286.

Исправили проверку `href` со спец.символами

Как вы помните, в Selenide 5.15.0 мы добавили проверку href.
Оказалось, что она неправильно работала, если в href затесались экранированные символы, как во второй строке:

  $("a").shouldHave(href("/foo/bar/details.html"));    // works
  $("a").shouldHave(href("/files/some%20file.pdf"));   // fails

Проблема исправлена.

См. issue 1298.
Спасибо rerednaw за PR 1299.

Разрешаем хрому скачивать несколько файлов

Бывают такие хитрые ссылки, по клику на которые браузер начинает скачивать не один, а сразу два или больше файлов.
Оказалось, что в этом случае браузер Chrome показывает диалог “Уверены, что хотите скачать все файлы?” - и этот диалог не даёт ничего дальше сделать, пока пользователь не нажмёт кнопку. И ваш тест падает.

Самое противное в этой проблеме то, что её очень сложно повторить руками: браузер показывает диалог только в первый раз, так что при локальном запуске скорее всего вы его не увидите, и тест будет зелёным.

Чтобы вылечить эту проблему, мы добавили при запуске хрома специальный ключик profile.default_content_setting_values.automatic_downloads=1, который сразу разрешает хрому качать сколько угодно файлов без всяких диалогов.

См. issue 1307.
Спасибо Alexei Vinogradov за PR 1308.

Разрешили скачивать файлы со слэшем в названии

Метод download не разрешает скачивать файл, если в его названии есть неразрешённые символы, в числе которых был и слэш:

  File report = $("#report").download();
  
  --> IllegalArgumentException("File name cannot contain slash: 11/08/2020_-_day_transactions.pdf")

Нам казалось это логичным, ведь такие файлы тупо не разрешает создавать файловая система.
Но оказалось, что иногда слэш вполне логичен - например, как разделитель в датах. И хром вполне скачивает такие файлы, просто заменяя слэш на подчёркивание.

Теперь и селенид так делает.

См. issue 1322 и PR 1323.

Зафиксировали версию Guava 30.0-jre

Ох уж эта гуава!

В коде самого селенида Guava не используется, нам она не нужна.
Но с ней вечные проблемы: от неё зависят многие другие библиотеки (Selenium, LittleProxy, BrowserUpProxy, Checkstyle), и все от разных версий. А ещё ведь у неё есть специальная версия для android…

В общем, слишком часто так случалось, что Maven или Gradle подтягивал не ту версию Guava, и селенид в итоге не работал.
Нам это надоело, и теперь в селениде явно прописана свежая версия Guava 30.0-jre. Надеемся, это поможет избежать всех этих бесконечных конфликтов завиимостей.

Перешли на Github Actions

Как в любом приличном проекте, в Selenide есть свой набор автотестов (юнит- и интеграционных), и они запускаются автоматически для всех веток на CI сервере. Раньше мы использовали Travis CI, который предоставляет бесплатный сервис для опен-сорс проектов. Спасибо им большое за годы совместной работы. :)

Но в этом году гитхаб выкатил свой CI сервис под названием “Github actions”.

Смотри обзор от Артём Ерошенко и Севы Брекелова в выпуске №3 Шоу “Ошибка выжившего”.

И казалось логичным использовать его.

Ура, этот день настал! Теперь все билды селенида видны прямо на гитхабе.

Спасибо Boris Osipov за PR 1319.

Уффф.

Многабукаф, но вы осилили. Все молодцы!

Как обычно - обновляйтесь, пробуйте, смело сообщайте о проблемах и делитесь идеями.

Андрей Солнцев

ru.selenide.org

Почему прокси не работает в Selenoid?

2020-11-17T00:00:00+00:00

Всем привет!

Сегодня мы наконец-то раскроем тайну, почему у многих не работает прокси в Selenoid.

Задача: скачать файл

Мы запускаем тесты, в которых браузер бежит в контейнере Selenoid (обычно также и на Selenide, но необязательно).
В ходе теста мы хотим скачать файл.
Метод по умолчанию $.download() не подходит (например, потому, что скачивание происходит не по прямой ссылке).
Поэтому мы хотим скачать файл через прокси.

Наши действия

Создаём проект
Добавляем в проект зависимость BrowserUpProxy, как указано в документации Selenide:
```
dependencies {
  testRuntimeOnly("com.browserup:browserup-proxy-core:2.1.1")
}
```

Копипастим типичный бойлерплейт для запуска браузера в Selenoid:

Configuration.proxyHost = "192.168.0.10";
Configuration.remote = "http://localhost:4444/wd/hub";
DesiredCapabilities capabilities = new DesiredCapabilities();
capabilities.setBrowserName("chrome");
capabilities.setVersion("85.0");
capabilities.setCapability("enableVNC", true);
capabilities.setCapability("enableVideo", true);
capabilities.setCapability("enableLog", true);
Configuration.browserCapabilities = capabilities;
Configuration.fileDownload = FileDownloadMode.PROXY;
Configuration.proxyEnabled = true;

Ну и пишем тест, что-то вроде

open("https://the-internet.herokuapp.com/download");
File file = $(byText("some-file.txt")).download();
assertThat(file.getName()).isEqualTo("some-file.txt");

Проблема

И получаем ошибку при открытии браузера:

org.openqa.selenium.WebDriverException: unknown error: net::ERR_TUNNEL_CONNECTION_FAILED
    ...
	at com.codeborne.selenide.Selenide.open(Selenide.java:49)
	at org.selenide.selenoid.FileDownloadTest.download(FileDownloadTest.java:45)

ААА, паника!

На этом месте большинство людей паникует, перебирает кучу опций браузера и селенидовских настроек и в конце концов пишет в чатик автоматизаторов.

А ведь всего-то надо было почитать внимательно лог.
В логе чётко видна проблема:

[LittleProxy-0-ProxyToServerWorker-1] ERROR org.littleshoot.proxy.impl.ProxyToServerConnection
                        - (HANDSHAKING) [id: 0xc05a41d5, L:/10.10.10.145:56103
                        - R:the-internet.herokuapp.com/52.1.16.137:443]
                        : Caught an exception on ProxyToServerConnection
java.lang.NoSuchMethodError: 'int io.netty.buffer.ByteBuf.maxFastWritableBytes()'
	at io.netty.handler.codec.ByteToMessageDecoder$1.cumulate(ByteToMessageDecoder.java:86)

Крутим зависимости

Ошибка NoSuchMethodError недвусмысленно намекает на то, что у нас проблема с зависимостями: в classpath оказались какие-то два JAR’а с несовместимыми версиями.

Против этого уже давно придумали прививку. Удивляюсь, почему так много людей до сих пор не в курсе.

Запускаем команду:

gradle dependencies, или
mvn dependency:tree

И вуаля! - чётко видим, какие у нас JAR’ы и каких версий. Ищем там что-то похожее на “netty”.

\--- com.browserup:browserup-proxy-core:2.1.1
     +--- io.netty:netty-codec:4.1.44.Final
     +--- xyz.rogfam:littleproxy:2.0.0-beta-5
     |    +--- io.netty:netty-all:4.1.34.Final

Как видим, у нас есть два джарника с разными версиями: netty-codec:4.1.44.Final и netty-all:4.1.34.Final.

Лечим зависимости

Чтобы исправить проблему, достаточно явно прописать в build.gradle или pom.xml более новую версию Netty:

testRuntimeOnly("io.netty:netty-all:4.1.54.Final")
testRuntimeOnly("io.netty:netty-codec:4.1.54.Final")

(на самом деле достаточно только одной из этих строк. Домашнее задание: какой и почему?)

Команда gradle dependencies показывает, что теперь версии совпадают:

\--- com.browserup:browserup-proxy-core:2.1.1
     +--- io.netty:netty-codec:4.1.44.Final -> 4.1.54.Final
     +--- xyz.rogfam:littleproxy:2.0.0-beta-5
     |    +--- io.netty:netty-all:4.1.34.Final -> 4.1.54.Final

Тест запускается, прокси работает, файл скачивается. Всем щастье.

Мораль

Будьте внимательнее к логам, братьям нашим меньшим!

Андрей Солнцев

ru.selenide.org

Вышла Selenide 5.15.0

2020-09-26T00:00:00+00:00

Всем привет!

Мы выпустили релиз Selenide 5.15.0.

Добавили настройку `Configuration.pageLoadTimeout`
(по умолчанию 30 секунд)

Бывает так, что вебдрайвер надолго подвисает, пытаясь загрузить какую-то страницу, либо картинку на этой странице, или ещё какой-то элемент. Теряется время, сессия обрывается по таймауту и т.д.

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

Поэтому мы добавили в Selenide настройку Configuration.pageLoadTimeout, чтобы этот таймаут было легко менять.

Внимание! Значение по умолчанию - 30 секунд. Если ваши тесты начали падать по таймауту - знайте, какую настройку подкрутить.

См. issue 1268 и PR 1269.

Добавили универсальный метод клика
с параметром `ClickOptions`

В некотором роде это новое слово в API селенида.

В селениде изначально был метод $.click(), который просто вызывал обычный селениумовский метод WebElement.click(). Который кликает (вроде как) в центр элемента.

Со временем начали появляться вариации:

Настройка Configuration.clickViaJs, чтобы кликать не вызовом WebElement.click(), а через JavaScript. Теоретически это должно сделать тесты стабильнее (а может, и быстрее) и позволит кликать то, что обычно не получается.
Клик со сдвигом $.click(offsetX, offsetY), чтобы кликать не в центр элемента

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

Поэтому мы добавили метод, в который можно явно передавать парметр - способ клика.

Теперь кликать можно без изменения глобальной настройки, хоть обкликайся:

  $("#page").click(usingJavaScript());
  $("#page").click(usingJavaScript().offset(123, 222));
  $("#page").click(usingJavaScript().offsetY(222));
  $("#page").click(usingDefaultMethod());

NB! Мы рекомендуем выставить настройку Configuration.clickViaJs в то значение, которое вам подходит в большинстве случаев, и задавать параметр ClickOptions точечно - только там, где он необходим.

См. issue 1173.
Спасибо Dmytro Stekanov за PR 1226.

Добавили универсальный метод скачивания файла
с параметром `DownloadOptions`

Аналогичная история была с методом $.download(). Изначально он умел скачивать файлы только одним способом - через GET запрос. Потом селенид научился скачивать файлы через прокси. Недавно мы добавили третий способ - FOLDER.
До сих пор способ скачивания можно было задать только через глобальную настройку Configuration.fileDownload.

А теперь способ скачивания можно задавать через параметр в каждый вызов $.download, не меняя глобальную настройку:

  File f = $("input").download(DownloadOptions.using(PROXY);
  File f = $("input").download(DownloadOptions.using(PROXY).withTimeout(9999));
  File f = $("input").download(DownloadOptions.using(PROXY).withFilter(withExtension("xls")).withTimeout(9999));
  File f = $("input").download(DownloadOptions.using(FOLDER);
  File f = $("input").download(DownloadOptions.using(FOLDER).withTimeout(9999));
  File f = $("input").download(DownloadOptions.using(FOLDER).withFilter(withExtension("pdf")).withTimeout(9999));

NB! Мы рекомендуем выставить настройку Configuration.fileDownload в то значение, которое вам подходит в большинстве случаев, и задавать параметр DownloadsOptions точечно - только там, где он необходим.

См. issue 1259 и PR 1260.

Добавили методы для работы с LocalStorage

import static com.codeborne.selenide.Selenide.localStorage;

// Очистить всё содержимое:
localStorage().clear();

// Добавить значение:
localStorage().setItem("username", "john");

// Проверить значение:
assertThat(localStorage().getItem("username")).isEqualTo("john");

// Проверить количество элементов:
assertThat(localStorage().size()).isEqualTo(1);

// удалить значение:
localStorage().removeItem("username");
assertThat(localStorage().getItem("username")).isNull();

Спасибо Dmytro Stekanov за PR 1274.

Добавили проверки для текст элемента без потомков

Классическая селенидовская проверка $.shouldHave(text("Hello, world")) включает и текст самого элемента, и тексты всех его потомков.
А иногда хочется проверить только текст самого элемента, без потомков. Для этого мы добавила две новых проверки:

  $.shouldHave(ownText("Hello"));           // Элемент должен содержать текст "Hello"
  $.shouldHave(exactOwnText("Hello"));      // Текст элемента должен быть "Hello" 

См. issue 1261 и PR 1262.

Ускорили работу с большими фильтрованными коллекциями

В селениде есть удобные методы для работы с коллекциями элементов: их можно удобно отфильтровать, в них можно искать элементы или разом проверить, скажем, тексты всех элементов.

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

ElementsCollection list = $$("li").filter(visible);   // На странице 100 элементов <li>
for (int i = 0; i < 10; i++) {
  list.get(i).shouldBe(visible);
}

Если на странице, предположим, 100 элементов <li>, то такой тест может очень долго работать.

Ведь селенид на каждом шагу должен перегрузить элемент - вдруг его состояние изменилось!
А чтобы перегрузить N-ный элемент коллекции, нужно перегрузить всю коллекцию (в селениуме ведь нет метода WebDriver.findElement(index)).
А чтобы перегрузить фильтрованную коллекцию, нужно пройтись по всем её элементам и применить фильтр для каждого (в данном примере - вызвать WebElement.isDisplayed()).

Для сравнения, такой цикл работает гораздо быстрее:

ElementsCollection unfiltered = $$("li");   // Нефльтрованная коллекция 
for (int i = 0; i < 10; i++) {
  unfiltered.get(i).shouldBe(visible);
}

В этом релизе мы немного ускорили работу с коллекциями. Теперь Селенид фильтрует коллекцию умнее: чтобы получить list.get(N), он применяет фильтр visible не для всех 100 элементов, а только для первых <N> элементов.

См. issue 1266 и PR 1270.

P.S. Напомню, что другой вариант ускорить тесты в таких случаях - использовать метод snapshot:

ElementsCollection list = $$("li").filter(visible).snapshot(); // snapshot() создаёт "слепок" коллекции. Селенид не будет её перегружать каждый раз. 
for (int i = 0; i < 10; i++) {
  list.get(i).shouldBe(visible);
}

Но при использовании snapshot есть риск словить StaleElementReferenceException, если коллекция всё-таки обновилась во время цикла.

Добавили проверку “href”

Иногда хочется в тесте проверить, что у элемента <a> правильное значение атрибута href, т.е. ссылки.
Для этого всегда можно было использовать метод $("a").shouldHave(attribute("href", "/foo/bar/details.html").

Проблема в том, что такая проверка очень неочевидно падает, потому что селениум возвращает абсолютный, а не относительный URL.
Подробнее см. в докладе Алексея Баранцева “Заморочки в Selenium WebDriver” с 57:11.

Чтобы хоть немножко облегчить эту заморочку, мы добавили проверку “should have href” для ссылок:

  `$("a").shouldHave(href("/foo/bar/details.html"))`

См. issue 1272 и PR 1273.

Добавили опцию хрома “–no-sandbox”

Я где-то вычитал, что она сделает тесты на хроме стабильнее. Скрестим пальцы и будем надеяться.

См. commit 3293956d

Селенид теперь явно кидает ошибку

… если не удалось создать папку для скачивания файлов.

См. issue 1265 и commit 94ece98f](https://github.com/selenide/selenide/commit/94ece98f).

Обновились на WebDriverManager 4.2.2

См. WDM Changelog.

Видеообзор

Смотрите видеообзор данного релиза.

Новости

Приходите 4-7 ноября 2020 на онлайн-конференцию Heisenbug!

Я там тоже буду выступать:

Воркшоп “Как начать свой проект автоматизации с нуля (с божьей помощью и Selenide)” - для начинающих
Доклад “Flaky tests. Метод” - для опытных

Андрей Солнцев

ru.selenide.org

Вышла Selenide 5.14.0

2020-08-17T00:00:00+00:00

Всем привет!

Мы выпустили релиз Selenide 5.14.0.

Стабилизировали новый способ скачивания файлов `FOLDER`

… который появился в Selenide 5.13.0.

Вот что поменялось в 5.14.0:

Каждый раз, когда селенид открывает браузер, он создаёт для него уникальную папку для скачиваний. Это помогает избежать ситуаций, когда параллельные тесты одновременно скачивают файлы в одну и ту же папку, и невозможно понять, где чей файл.

См. issue 1220 и PR 1221.
- Увы, это не работает для IE и Safari (которые в принципе не позволяют задать папку для скачивания файлов)
- Также это работает только для тех браузеров, которые открывает селенид.
- Если же вы сами открываете браузер и передаёте его селениду, вам нужно будет создать уникальную папку самостоятельно и передать её селениду:
  - Либо с помощью нового метода setWebDriver(driver, proxy, downloadsFolder),
  - либо конструктора SelenideDriver(..., downloadsFolder).
Перед началом каждого скачивания файла селенид очищает папку – см. PR 1252
Селенид удаляет все пустые папки для скачиваний в конце тестов – см. PR 1247

Добавили проверку `$$.shouldHave(itemWithText("any text"))`

В отличие от классической $$.shouldHave(texts("text1", "text2")), она означает, что в коллекции есть хотя бы один элемент с данным текстом.

Спасибо Luis Serna за PR 1194.

Кстати, это первый коммит в селенид аж из Боливии!

Добавили поддержку браузера Safari

Когда-то селенид поддерживал Safari, но тогда куча всего в нём не работало.
В какой-то момент нам надоело с ним мучаться, и мы поддержку выпилили.
Но сейчас попробовали новый подход. Вроде как завелось (не всё, конечно).

Как обычно, достаточно просто прописать

Configuration.browser = "safari"; либо
-Dselenide.browser=safari

Делитесь впечатлениями.

См. issue 1236 и PR 1237.

Добавили метод `SelenideDriver.screenshot(fileName)`

Полезно, если вы создаёте “нестатический” вариант драйвера (new SelenideDriver()) и хотите снимать скриншоты.
Теперь можно.

См. issue 1166 и PR 1227.

Добавили метод `SelenideDriver.screenshot(OutputType)`

Иногда хочется получить скриншот в формате Base64. Например, этот формат хотят некоторые инструменты для сравниения скриншотов.

Теперь их можно получить таким вызовом:

String screenshot = Selenide.screenshot(OutputType.BASE64);
byte[] decoded = Base64.getDecoder().decode(screenshot);
BufferedImage img = ImageIO.read(new ByteArrayInputStream(decoded));

См. issue 1224 и PR 1231.

Теперь селенид снимает скриншот в случае падения `switchTo()`

Как вы знаете, Селенид автоматически делает скриншот в случае падения тестов.
Но мы обнаружили, что Селенид НЕ делал скриншот, если упал один из этих методов:

switchTo(frame)
switchTo(window)
switchTo(alert)

Теперь мы исправили эту досадную оплошность.

См. issue 1190 и PR 1240.

Добавили хрому опцию `--disable-dev-shm-usage`

Мы тут вычитали, что без этой опции Chrome может крэшиться из-за out of memory error.

Почему никто из вас на это не жаловался?
Стало ли лучше после добавления это опции?

P.S. Позже люди жаловались и на наличие этой опции. Эпопея пока не окончена.

Исправили работу Sizzle селекторов на страницах с Dojo.js, troop.js и т.п.

См. issue 434 и PR 1242.

Сделали метод `$.toString()` безопаснее

См. issue 1241 и PR 1245.

Улучшили сообщение об ошибке, если элемент внезапно пропал

См. issue 1013 и PR 1239.

Обновились на WebDriverManager 4.1.0

См. WDM Changelog.

Видеообзор

Смотрите видеообзор данного релиза.

Новости

Ничоси! Курс на Udemy “Selenium и Selenide для начинающих Automation QA, QC на Java”
Про селенид на немецком
Пример проекта на Selenide+Selenoid+Docker от d3m0
Ещё пример: сравнение скриншотов с Selenide+Allure+Ashot+Screen Diff Plugin от Evgeniy Asovin
Ещё пример: Selenide + Appium + Allure + TestNG от qaschevychelov
Сравнение Selenide и Selenium 2019 года: Choosing tools for UI testing: Selenium or Selenide? - 17.09.2019
Статья Jakub Skibiński в блоге компании Sonalake: Selenide: A Powerful Testing Framework - 19.06.2020
Статья “Почему мы перешли на Selenide, попутно написав более 200 новых автотестов” - 30.04.2020
Switch from Serenity to Selenide - 22.05.2020 от Yuri Kudryavtsev (Maxilect company)

И целая серия статей от Alexander Pushkarev:

Андрей Солнцев

ru.selenide.org

Вышла Selenide 5.13.0

2020-07-08T00:00:00+00:00

Всем привет!

Лето не повод расслабляться! Мы выпустили релиз Selenide 5.13.0.

Будьте осторожны, он может сломать ваши тесты (если они были неаккуратно сделаны).

Метод `$.shouldHave(text(""))` кидает ошибку

Возможно, самый популярный метод селенида - это $.shouldHave(text("что-то")). Но даже если вы используете его каждый день, возможно, вы не подозреваете, что он проверяет подстроку. Т.е. проверка $("h1").shouldHave(text("ello")) сработает и для элемента <h1>Hello World</h1>.

Частный случай такой проверки - $("h1").shouldHave(text("")). Такую проверку пройдёт любой элемент, ведь любая строка содержит пустую подстроку. То есть такая проверка просто бессмысленна.

Если вам нужно убедиться, что текст пустой, используйте $("h1").shouldHave(exactText("")) или $("h1").shouldBe(empty).

Мы хотим вам помочь избежать этой типичной проблемы и избавиться от бессмысленных проверок. Для этого теперь селенид будет бросать ошибку, если вы попытаетесь передать в метод text("") пустую строку или null.

Я попробовал Selenide 5.13.0 на своём рабочем проекте и внезапно нашёл тестов 20-30, которые падали с этой ошибкой. И это всё были логические ошибки в тестах! Вот какое полезное изменение вас ждёт. :)

См. issue 1156.
Спасибо Roman S.A. за PR 1186.

Убрали лишние логи из аллюра

Внимательные аллюровцы заметили, что селенид логирует одно и то же действие дважды. Например, при вызове такой строки:

  $(bySelector).findAll(BySelector).filter(condtion);

(на самом деле не только в аллюре, но и в обычном селенидовском TextReport)

Теперь мы убрали эти двойные логи. Пришло кое-чего порефакторить, некоторые сообщения об ошибках изменились.
Но вроде бы всё стало лучше. Если заметили ухудшение - смело сообщайте.

См. issue 997 и PR 1193.

Улучшили сообщение об ошибках для коллекций

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

См. issue 967 и PR 1189.

Починили загрузку файлов вне тэга `<form>`

Как вы знаете, селенид позволяет загрузить одной командой несколько файлов:

  $("input").uploadFile(
    new File("a.txt"),
    new File("b.txt"),
    new File("c.txt")
  );

Для этой загрузки мы в своё время сделали в селениде хитрый JS хак. Оказалось, что этот хак предполагал, что <input> для загрузки файла должен быть внутри тэга <form>. Что как бы логично.
Но оказалось, что не у всех так.

В общем, теперь мы упростили хак и убрали зависимость от тэга <form>.

См. issue 943 и PR 1188.

Научились скачивать файлы с кавычками в имени

… и другими нехорошими символами.

Оказывается, есть и такие чудаки, которые генерируют файлы, в имени которых есть кавычки. Линукс и Мак вполне умеют сохранять такие файлы, а вот винда никак. Теперь селенид заменяет кавычки и другие нехорошие символы на подчёркивания (как делают все основные браузеры).

См. issue 1196 и PR 1199.

Научили вебдрайвер писать свои логи в файл

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

Теперь же селенид включает логи вебдрайвера. Логи пишутся в файлы вида build/reports/tests/webdriver.ts_pid_tid.log.
Полный путь к файлу вы можете узнать из лога, который пишет селенид каждый раз при открытии браузера:

INFO Write webdriver logs to: /andrei/build/reports/tests/webdriver.1594248139109_18125_1.log

Когда в следующий раз будете изучать аномальное поведение вебдрайвера, не забудьте туда заглянуть.

См. issue 1206 и PR 1207.

Добавили новый способ скачивания файлов `FOLDER`

Как вы знаете, до сих пор в селениде было два способа скачивания файлов: HTTPGET и PROXY. См. пост в нашем блоге.

HTTPGET - самый простой и надёжный. Но умеет скачивать только файлы с ссылки вида <a href>.
PROXY - универсальный и мощный способ. Но при удалённом запуске требует доступа с машины браузера к машине тестов. Что порой вызывает сложности и поклонников Селеноида и Грида.

Теперь появился третий способ: FOLDER.

Чтобы его включить, просто пропишите в начале тестов:

Configuration.fileDownload = FileDownloadMode.FOLDER;

Работает он просто:

Кликает элемент
Смотрит, какие новые файлы появились в папке build/downloads
Если таких файлов несколько, пытается угадать, какой из них подходит лучше всего.

Рабочий пример всегда можно найти в тестах самого селенида.

P.S. Будем пока считать этот способ экспериментальным, поскольку есть нюансы:

Работает надёжно при локальном запуске в один поток
При параллельном запуске одновременные тесты могут скачивать файлы в одну и ту же папку, и тогда селенид не сможет определить, кому какой файл отдать.
При удалённом запуске этот способ вообще пока не работает. Тесты-то здесь, а папка там!
Поддерживаются Chrome, Firefox, Edge, Opera. Не поддерживаются IE и Safari (у в принципе нет возможности задать папку для скачивания файлов).

Мы будем работать над этим, а вы делитесь своими соображениями, как разрулить вышеозначенные проблемы.

См. issue 1212, PR 1213 и PR 1215.

Метод `$.getWrappedElement()` снова ждёт появления элемента

Вряд ли вам это интересно, но упомянуть обязан. По сути мы откатили одно недавнее изменение.

Допустим, у вас есть такой код:

SelenideElement button = $("button");
executeJavascript("arguments[0].click()", button);

где button, допустим, появляется на экране с задержкой.
Всю жизнь этот метод ждал появления кнопки, и лишь тогда кликал. В Selenide 5.11 нас укусила какая-то собака, и мы сделали так, чтобы не ждал. Никто почему-то не жаловался, а вот в моём рабочем проекте несколько тестов упали.

В общем, теперь мы вернули обратно старое поведение. Теперь снова ждёт.

См. issue 1191 и PR 1203.

Обновились до BrowserUpProxy 2.1.1

Ну вдруг.

Обновляйтесь, пробуйте, делитесь впечатлениями!

Статистика

И моё любимое: статистика скачиваний селенида. Мы пробили потолок в 160 тысяч в месяц!

и 31+ тысяча уникальных айпишников:

Жизнь хороша!

Андрей Солнцев

ru.selenide.org

Вышла Selenide 5.12.2

2020-05-29T00:00:00+00:00

Всем привет!

Ловите ещё один мини-релиз Selenide 5.12.2.

Подправили аннотации @Nonnull

… для некоторых методов SelenideElement.

После обновления на Selenide 5.12.0 некоторые пользователи котлина начали жаловаться, что их проекты переставил компилироваться.
Всё дело в том, что мы пометили все методы SelenideElement аннотациями @Nullable/@Nonnull, а котлин к ним чуток.

Для следующих методов мы теперь прописали @Nonnull, потому что дополнительная проверка показала, что они никогда не возвращают null:

$.getText()
$.text()
$.innerText()
$.innerHtml()
$.getSelectedText()

Теперь в котлине их можно по-прежнему пихать в ненулевые переменные (хоть мне и кажутся сомнительными такие конструкции в тестах).

См. issue 1179 и PR 1181.

Исправили работу настройки `holdBrowserOpen=true`

Эта настройка срабатывала не всегда. Уже давно.
И мы давно об этом знали, но забывали, потому что никто нам issue на гитхабе не заводил. :(

В общем, исправили. При заданной настройке Configuration.holdBrowserOpen=true браузер остаётся открытым после окончания тестов и вообще всех потоков.

См. issue 1172 и PR 1176.

Видосики

Видео Тяжелое утро с Heisenbug #2 со мной. Вопросы, до которых обычно на конференциях не до.
Всеволод Брекелов и Артём Ерошенко в “Ошибке выжившего #4” в прямом эфире пишут экспорт Record&Play в Selenide. Представляете!
Мы опубликовали Selenide Roadmap. Ждём ваших отзывов!

Новости

Ура!

Свершилось!

Мы опубликовали плагин для Selenium IDE, который умеет экспортировать код в Selenide.

Мы скоро напишем об этом отдельную статью.

Большое спасибо Dmytro Stekanov за этот исторический для селенида момент!

Андрей Солнцев

ru.selenide.org

Вышла Selenide 5.12.1

2020-05-25T00:00:00+00:00

Всем привет!

По горячим следам вы выпустили багфикс релиз Selenide 5.12.1 с парочкой мелких исправлений для Selenide 5.12.0.

Исправили Concurrent modification exception при инициализации вебдрайвера

См. issue 1170 и PR 1171.

Исправили мержинг настройки “excludeSwitches” разных типов

Оказывается, настройку excludeSwitches можно задать и как массив, и как список:

  chromeOptions.setExperimentalOption("excludeSwitches", new String[]{"enable-automation", "load-extension"});
  chromeOptions.setExperimentalOption("excludeSwitches", asList("enable-automation", "load-extension"));

Селенид 5.12.0 ломался, если задать вперемежку и так, и так. Починили.

См. issue 1169 и PR 1174.

Новости

Мы опубликовали Selenide Roadmap. Ждём ваших отзывов!
Видео с митапа pro:TEST - Чехия, 28.04.2020
Видео с митапа QA meetup - Словакия, 12.05.2020
Всеволод Брекелов и Артём Ерошенко запустили шоу “Ошибка выжившего”. Я посмотрел первые 4 выпуска - годно!
Ребята и девчонки из jug.ru запустили шоу “Тяжелое утро с Heisenbug”.
Ближайший выпуск будет со мной, ура-ура! 27 мая 2020

Андрей Солнцев

ru.selenide.org

Вышла Selenide 5.12.0

2020-05-23T00:00:00+00:00

Всем привет!

Ура, релиз Selenide 5.12.0.

Большая часть изменений касается настроек браузеров.

Порешали старинную проблему с `Configuration.browserCapabilities`

Люди давно уже жаловались на то, что часть настроек в ChromeOptions теряется (при некоторых условиях). Вызвана она была старой багой в Selenium, которой никто особо не занимается. И мы не хотели ввязываться.

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

Если вам помогло - делитесь.
Если не помогло - тем более делитесь, будем докостыливать дальше.

См. issue 676, issue 1097 и PR 1155.

Отдельное спасибо за попытки, которые не попали в релиз, но навели нас на итоговое решение:

Спасибо Boris Osipov за PR #1103
Спасибо SeleniumTestAB за PR #1095

Выключили раздражающий диалог “save password?”

См. issue 1133 и PR 1134.

Добавили режим “эмуляции мобильника” в гриде

Как вы знаете, в Selenide 5.6.1 появилась возможность запускать хром в режиме “эмуляции мобильного браузера”:

java -Dchromeoptions.mobileEmulation="deviceName=Nexus 5"

Но эта опция срабатывала только при локальном запуске хрома, и не передавалась при запуске хрома в гриде.
Теперь мы это починили: в грид передаются все настройки хрома, которые используются и при локальном запуске (кроме “папки для скачивания файлов”).

См. issue 1109 и PR 1163.

Упростили сетап Firefox: теперь без профиля

При открытии браузера Firefox селенид создавал ему профиль (FirefoxProfile) - как минимум, чтобы задать папку для скачивания файлов.
Оказалось, что использование профиля накладывает некоторые ограничения, и вообще не нужно (вроде как когда-то он был нужен для legacy firefox driver).

Теперь мы по умолчанию обходимся без профиля:

Папку для скачивания файлов создаём через firefoxOptions.addPreference("browser.download.dir")
Создаём профиль, только если вы специально задали системные свойства, начинающиеся на "firefoxprofile.".

См. issue 1139 и PR 1165.

Задаём настройку `"ACCEPT_INSECURE_CERTS"` для версий Edge, построенных на движке chromium

Начиная с какой-то версии, браузеры IE и Edge перестали поддерживать настройку "ACCEPT_INSECURE_CERTS" (разрешение самоподписанных SSL сертификатов). И мы выпилили эту настройку для IE и Edge (в Selenide 5.9.0).

Но оказалось, что более поздние версии Edge, которые построены на движке Chromium, снова начали её поддерживать.
Поэтому мы вернули настройку "ACCEPT_INSECURE_CERTS" для версий Edge 75 и выше.

Важно: версию Edge селенид может узнать, только если EdgeDriver был скачан с помощью WebDriverManager (что в селениде случается по умолчанию).

См. issue 1093 и PR 1167.

Обновились на WebDriverManager 4.0.0

Поддержка Firefox 76
Поддержка Edge 81, 83, 84
Обновили Apache HttpClient с 4.x на 5.0

См. PR 1149 и WDM Changelog.

Обновились на browserup-proxy-core:2.1.0

Ну мало ли.

Исправили имя папки для скриншота ‘emptyMethod’

Проблема касалась только JUnit 5.

Спасибо Denis Gaievsky за PR 1138

Расставили аннотации `@Nullable` и `@Nonnull`

Это поможет IDEA (и надеюсь, другим IDE) лучше подсвечивать косяки в ваших тестах.
А также это поможет пользователям Kotlin правильно использовать nullable/non-nullable типы.

И снова спасибо Yuriy Artamonov за PR 1140 и PR 1144!

Новости

Мы опубликовали Selenide Roadmap. Ждём ваших отзывов!
Видео с митапа pro:TEST - Чехия, 28.04.2020
Видео с митапа QA meetup - Словакия, 12.05.2020
Всеволод Брекелов и Артём Ерошенко запустили шоу “Ошибка выжившего”. Я посмотрел первые 4 выпуска - годно!
Ребята и девчонки из jug.ru запустили шоу “Тяжелое утро с Heisenbug”.
Ближайший выпуск будет со мной, ура-ура! 27 мая 2020

Андрей Солнцев

ru.selenide.org

Вышла Selenide 5.11.1

2020-04-21T00:00:00+00:00

Всем привет!

Похоже, релиз Selenide 5.11.0 всё-таки сломал слишком много устоев, и мы решили сбавить обороты. :)

Меняем ваше возмущение на Selenide 5.11.1.

SLF4J

Народные массы возмутил тот факт, что в версии 5.11.0 селенид безусловно стал требовать правильной зависимости slf4j. Народные массы не хотят настраивать slf4j и в гробу видали наши логи. :)

Для нас это было неожиданно, но мы идём навстречу трудящимся.

Теперь селенид требует slf4j не всегда, а только в тех редких случаях, когда без него точно никак. А именно, если вы включите фичу TextReport.

because we can!

В Selenide 5.11.0 мы сделали одну (почти незаметную) багу, связанную с использованием because. А именно,

$("blah").shouldNot(exist) - не падает (это ок)
$("blah").shouldNot(exist.because("we can")) - падает (а вот это не ок)

Слово because оказалось несовместимым с отрицанием. Теперь мы это исправили, и обе строчки не падают.

См. issue 1130 и 1131.

Сбросили 16 мегабайт

Оказывается, среди зависимостей селенида затесался 16-мегабайтный файл checker.jar.
Мы с лёгкостью от него избавились.

Спасибо Yuriy Artamonov за PR 1128.

Новости

Во вторник 28 апреля я буду выступать на чешском митапе [pro:]TEST!
Поскольку митап онлайн, участвовать будут все желающие. Можете позвать друзей, которые ещё не знают про селенид!

Язык: ломаный английский
Дата: 28.04.2020, 18:00 GMT+2
Уровень: скорее для начинающих
Ссылки: Анонс / Трансляция

Добро пожаловать!

Андрей Солнцев

ru.selenide.org

Вышла Selenide 5.11.0

2020-04-19T00:00:00+00:00

Всем привет!

Мы выпустили Selenide 5.11.0.
Это уже второй карантинный релиз Selenide. И чтобы вам не засохнуть от скуки, мы сделали парочку существенных изменений.

Поменяли поведение `shouldNot*` проверок для несуществующего элемента

Просто взгляните на следующую таблицу, чтобы понять, что поменялось.
Предположим, что элемент h1 не найден на странице.

Проверка	Selenide 5.10-	Selenide 5.11+
`h1.shouldNot(exist)`	ok	ok
`h1.shouldNotBe(visible)`	ok	ok
`h1.shouldBe(hidden)`	ok	ok
`h1.shouldNotHave(text("foo"))`	ok	FAIL
`h1.shouldNotHave(attribute("bar"))`	ok	FAIL
`h1.find("h2").shouldNot(exist)`	ok	ok
`h1.find("h2").shouldNotHave(text("foo"))`	ok	FAIL

Старая логика

Когда-то давно в селениде было принято такое решение: проверка h1.shouldNotHave(text("foo")) не должна падать: нет элемента - нет и текста. Значит, условие “should not” выполнено.

Эту логику подкрепляло и такое соображение: проверка h1.shouldHave(text("foo")) валится, а “shouldNot” - её отрицание, поэтому она валиться не должна.

Новая логика

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

См. issue 368 и PR 1116.

Теперь Селенид ругается, если SLF4J не настроен

Если вы увидите такое сообщение:

java.lang.IllegalStateException: SLF4J is not configured. You will not see any Selenide logs. 
  Please add slf4j-simple.jar, slf4j-log4j12.jar or logback-classic.jar to your classpath. 
  See https://github.com/selenide/selenide/wiki/slf4j

то не пугайтесь - просто сделайте, что там сказано. Это очень просто.

Какую проблему мы решали?

Проблема в том, что если у вас в проекте не была подключена никакая реализация SLF4J, то вы могли не увидеть какие-то важные логи селенида, в т.ч. “текстовой отчёт”. Теперь вам придётся подключить какую-нибудь реализацию SLF4J.

См. issue 1114 и PR 1115.

Добавили метод для частичной проверки атрибута

До сих пор в селениде были методы для проверки

наличия атрибута, и
точного значения атрибута:

  $("#domain-container").shouldHave(attribute("class"));
  $("#domain-container").shouldHave(attribute("class", "container"));

Теперь мы добавили метод attributeMatching для проверки частичного значения атрибута.
См. примеры в тестах:

@Test
void canVerifyAttributeMatching() {
  $("#domain-container").shouldHave(attributeMatching("class", "contain.*"));  // class="container"
  $("#domain-container").shouldHave(attributeMatching("class", ".*tainer"));
  $("#domain-container").shouldHave(attributeMatching("class", ".+tain.+"));
}

См. issue 996.
Спасибо Dmytro Stekanov за PR 1100.

Добавили метод для получения последнего скриншота

Добавили два новых метода:

Screenshots.getLastThreadScreenshot() - возвращает последний скриншот, сделанный селенидом в текущем потоке
Screenshots.getThreadScreenshots() - возвращает все скриншоты, сделанные селенидом в текущем потоке

Обычным пользователям эти методы ни к чему: селенид и так добавляет информацию о скриншоте к сообщению об ошибке.
Но эти новые методы могут быть полезны тем, кто пишет какие-нибудь свои фреймворки на основе селенида или интегрирует селенид с фреймворками типа Аллюра.

См. issue 1029.
Спасибо Dmytro Stekanov за PR 1125.

Добавили аннотацию `@CheckReturnValue` к большинству публичных методов селенида

Это позволит IDE (как минимум Intellij IDEA) лучше анализировать код ваших тестов и предупреждать, если вы вызвали какой-нибудь селенидовский метод, но забыли проверить результат:

Спасибо Yuriy Artamonov за PR 1106.

Добавили нехватающий метод `Selectors.byTagName()`

Просто чтобы было консистентно с By.

Спасибо Yuriy Artamonov за PR 1104.

Исправили URL скриншота

… когда проект запускается на дженкинсе, и в имени проекта есть пробел.

См. issue 1072.
Спасибо Dmytro Stekanov за PR 1098.

Отключили предупреждение о расширениях в Chrome

Честно говоря, я так и не понял, при каких условиях это предупреждение появляется - лично я его не видел:

Но некоторые товарищи жаловались. Теперь мы его отключили вот такой настройкой:

options.setExperimentalOption("excludeSwitches", new String[]{"enable-automation", "load-extension"});

Дайте знать, если у вас это вызовет какие-то проблемы.

См. issue 1119 и PR 1120.

Теперь можно установить `selectorMode` и `assertionMode` через системные свойства

Никто этого не просил - просто для консистентности.

См. коммит 231597eb6229e.

Метод `$.getWrappedElement()` больше ничего не ждёт

Подозреваю, что большинство из вас не знали о существовании этого метода и тем более не использовали его.
Его идея была в том, чтобы дать автору теста доступ к оригинальному селениумовскому WebElement без всякой селенидовской магии (ну мало ли кому-то понадобится). А Iakiv Kramarenko заметил, что без селенидовской магии не обошлось: метод $.getWrappedElement() всё-таки ждал появления элемента.

Теперь он больше ничего не ждёт. Если элемента нет - он сразу кидает селениумовский org.openqa.selenium.NoSuchElementException. Ну и легендарный StaleElementReferenceException вы тоже можете отхватить, конечно (ну мало ли кому-то захочется вспомнить молодость).

См. issue 1015 и PR 1124.

Статистика

И моё любимое: статистика скачиваний селенида. Мы пробили потолок в 130 тысяч в месяц!

и 23 тысячи уникальных айпишников:

Жизнь хороша!

Андрей Солнцев

ru.selenide.org

Вышла Selenide 5.10.0

2020-03-18T00:00:00+00:00

Здоровендос!

Шёл третий день карантина.

Чтобы вам не было одиноко, мы выпустили Selenide 5.10.0 с кучей улучшений, некоторые из которых даже окажутся капельку обратно несовместимыми. Ну, чтобы вы не скучали в своих берлогах.

Добавили поддержку Shadow DOM

См. примеры в тестах:

$(shadowCss("#anyButton", "#shadow-host")).click();

$(shadowCss("p", "#shadow-host")).shouldHave(text("Inside Shadow-DOM"));

$(shadowCss("p", "#shadow-host", "#inner-shadow-host")).shouldHave(text("The Shadow-DOM inside another shadow tree"));

Firefox: Вызов setValue("test") / val("text") на input элементе выкидывает ошибку “not reachable by keyboard”.
Как временное решение, можно использовать fastSetValue=true:

Configuration.fastSetValue = true;
$(shadowCss("input", "#shadow-host")).setValue("test");

См. issue 1014.
Спасибо Dmytro Stekanov за PR 1090.

Selenide больше не тянет BrowserUpProxy по умолчанию

Изначально это предложил Алексей Баранцев, так что бейте его, если что. :)

Мы сопоставили вместе два факта:

Селенид по умолчанию тянет за собой BrowserUpProxy и его зависимости - всего ~17 мегабайт.
Большинство пользователей (наверное) не использует селенидовский прокси.

и решили обрадовать Грету Тумберг и не качать эти 17 мегабайт по умолчанию.

Зависимость

Те из вас, кто использует прокси, просто должны добавить в свой проект ещё одну зависимость:

testRuntime 'com.browserup:browserup-proxy-core:2.0.1'

(у многих из вас она и так уже есть).

Если вы забудете добавить зависимость - не беспокойтесь, вы увидите понятное сообщение:

java.lang.IllegalStateException: Cannot initialize proxy. Probably you should add BrowserUpProxy dependency to your project.
    at com.codeborne.selenide.drivercommands.CreateDriverCommand.createDriver(CreateDriverCommand.java:44)
    ...
    at com.codeborne.selenide.Selenide.open(Selenide.java:41)
caused by: java.lang.NoClassDefFoundError: com/browserup/bup/BrowserUpProxy

См. issue 1021 и PR 1094.

UPD 12.03.2023 В наше время больше не нужно добавлять ту зависимость browserup-proxy-core. Просто используйте com.codeborne:selenide-proxy вместо com.codeborne:selenide, и все нужные зависимости подтянутся автоматически.

Просто из интереса

Кто же там сжирает эти 17 мегабайт, спросите вы? А вот кто.
Вот полный список файлов, которые должны у вас пропасть из проекта. Список впечатляет, правда?

animal-sniffer-annotations-1.17.jar
barchart-udt-bundle-2.3.0.jar
bcpkix-jdk15on-1.62.jar
bcprov-jdk15on-1.62.jar
browserup-proxy-core-2.0.1.jar
browserup-proxy-mitm-2.0.1.jar
checker-qual-2.5.2.jar
dec-0.1.2.jar
dnsjava-2.1.9.jar
error_prone_annotations-2.2.0.jar
failureaccess-1.0.1.jar
guava-27.1-jre.jar
jackson-annotations-2.9.9.jar
jackson-core-2.9.9.jar
jackson-databind-2.9.9.1.jar
javassist-3.25.0-GA.jar
javax.activation-api-1.2.0.jar
jaxb-api-2.3.1.jar
jcl-over-slf4j-1.7.28.jar
jsr305-3.0.2.jar
jzlib-1.1.3.jar
listenablefuture-9999.0-empty-to-avoid-conflict-with-guava.jar
littleproxy-2.0.0-beta-5.jar
netty-all-4.1.39.Final.jar

Кто придумал название “animal-sniffer”? Это что вообще такое - нюхальщик животных?

Поменяли Guava API на соответствующие Java API

Мы просто поменяли

com.google.common.base.Predicate из Guava
на java.util.function.Predicate из Java 8

и выкинули Guava. Guava, ты была хороша и сделала много полезного (пока не вышла Java 8). Покойся с миром.

Если вы реализовали свои CollectionCondition, вам придётся метод apply переименовать в test. Это должно быть легко.

См. issue 1091.
Спасибо Wladimir Schmidt за PR 1091.

Сделали селенидовский отчёт в Allure чуточку красивее

На самом деле просто добавили кавычки вокруг селекторов.
Не представляю, зачем это может понадобиться, но теперь можно копировать селекторы из аллюровского отчёта и вставлять в developer console браузера, и они будут работать.

См. issue 1032.
Спасибо Dmytro Stekanov за PR 1092.

Добавили условие `$("img").shouldBe(image)`

Позволяет проверить, что картинка есть, она загрузилась и всё в порядке.

См. примеры в тестах:

$("#valid-image img").shouldBe(image);
$("#valid-image").shouldNotBe(image);
$("h1").shouldNotBe(image);

См. issue 1069.
Спасибо Dmytro Stekanov за PR 1086.

Исправили поиск элементов по атрибуту, который содержит кавычки

Я не знаю, каким надо быть извращенцем, чтобы в html атрибут запихать кавычки, но такие нашлись. А селенид оказался к этому не готов и генерировал невалидный CSS локатор. Теперь это в прошлом.

См. issue 1060.
Спасибо Denys Lystopadskyy за PR 1062.

Видосики

Немногие задумывались об этом, но возможно, SeleniumCamp 2020 - Последняя Конференция Человечества.

Но они ещё и последние альтруисты человечества, потому что из-за карантина они досрочно выложили все видео с последней конференции в открытый доступ.
Лечитесь, айтишники, и просвещайтесь!

Там есть три моих доклада:

Flaky tests: The method
BOF: прошлое и будущее селенида
Тройничок: Selenide для Web, Android и iOS – “Толерантные локаторы”!

И ещё из того, что я успел заметить:

Aleksei Tiurin - Solving the problems of Espresso Android autotests
Michael Bodnarchuk - Puppeteer is a new WebDriver? Secrets of flawless testing.
Oleksandr Khotemskyi - WebdriverIO + Puppeteer. Double gun – double fun
Sergey Pirogov - Test coverage myth busted
Mikalai Alimenkou - Static analysis tools as the best friend of QA

Андрей Солнцев

ru.selenide.org

Вышла Selenide 5.9.0

2020-03-10T00:00:00+00:00

Здоровендос!

По всему миру объявлена пандемия flaky тестов, и мы ищем новые лекарства для борьбы с ними.

Сегодня мы выпустили Selenide 5.9.0 с одной фичей, которая может помочь справиться с моргающими тестами.

Добавили фильтр для скачивания файлов: `$.download(FileFilter)`

Проблема

При скачивании файлов через прокси селенид может иногда скачать не тот файл.
Селенид ведь как скачивает файлы: кликает на кнопку “Скачать” и перехватывает ответ сервера браузеру.

Но иногда в этот момент между браузером и сервером могут лететь какие-нибудь левые запросы, никак не связанные со скачиванием. Например, хром решает проверить обновления. Или ваше приложение шлёт запросы в google analytics. Или просто какие-то фоновые запросы. Это создаёт плодотворную почву для появления flaky тестов, которые у вас на машине работают, а на дженкинсе иногда падают.

Решение

Чтобы избежать таких коллизий, теперь вы можете явно указать, какой файл вы ждёте.
Из коробки есть фильтры по имени и расширению файла, но вы можете создавать свои объекты FileFilter с какими угодно критериями.
И тогда из всех ответов сервера браузеру селенид выберет тот, который подходит под ваш фильтр.

См. примеры в тестах:

File f1 = $("#downloadMe").download(withName("hello_world.txt"));
File f2 = $("#downloadMe").download(withNameMatching("hello_.\\w+\\.txt"));
File f3 = $("#downloadMe").download(timeout, withExtension("txt"));

См. issue 1065 и PR 1080.

Исправили ошибку при старте IE 3.150

См. issue 1061.
Спасибо Boris Osipov за PR 1075.

Исправили ошибку при старте Microsoft Edge

См. issue 1039.
Спасибо Boris Osipov за PR 1084.

Новости

Забавный диалог получился в твиттере: контрибьютор проектов Selenium и Watir Titus Fortner признался, что видел мой доклад про селенид на SeleniumConf и спёр оттуда несколько идей для Watir, а я признался, что некоторые вещи в селениде изначально были спёрты из Watir.
Хорошая статья Modern Best Practices for Testing in Java. Масса правильных мыслей.
Статья Selenide Test Automation: Using Selenoid in the Docker Container
Статья Parametrized UI testing with Selenide and Junit 5
Некий базовый проект qa-automation-base, в котором намешаны Kotlin + Selenide/Appium + JUnit 5 + Allure + Allure EE + TestRail.

Статистика

Ну и на десерт - статистика скачиваний селенида. Растём!

Андрей Солнцев

ru.selenide.org

Вышла Selenide 5.8.0

2020-02-28T00:00:00+00:00

Приветос!

Мы подбили ещё пачку пуллреквестов и выпустили Selenide 5.8.0.

Какие же обновления нас ждут?

Упростили создание своих условий с помощью лямбд

В классе Condition появился новый метод match, который позволяет добавлять свои проверки, не создавая подклассов Condition. Ему надо просто скормить лямбду.

См. примеры в тестах:

$("#multirowTable").should(match("border=1", el -> el.getAttribute("border").equals("1")));

Также появились похожие методы для коллекций anyMatch, allMatch и noneMatch. См. примеры в тестах:

$$("input").shouldBe(anyMatch("value==dog", el -> el.getAttribute("value").equals("dog")));
$$("input").shouldBe(allMatch("value==cat", el -> el.getAttribute("value").equals("cat")));
$$("input").shouldBe(noneMatch("value==bird", el -> el.getAttribute("value").equals("bird")));

См. issue 662.
Спасибо Dmytro Stekanov за PR 1059.

Добавили методы `$.sibling()` и `$.preceding()`

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

См. примеры в тестах:

$("#multirowTableFirstRow").sibling(0).shouldHave(id("multirowTableSecondRow"));
$(".second_row").parent().preceding(0).find("td", 0).shouldHave(cssClass("first_row"));

См. issue 845.
Спасибо Dmytro Stekanov за PR 1064.

Запилили поддержку псевдо-элементов

Как многие знают, в HTML есть такие штуковины как псевдо-элементы: “:before”, “:after”, “:first-letter”, “:first-line”, “:selection”. Они могут содержать важный текст и стили, которые иногда важно протестировать. Теперь вы можете это сделать.

См. примеры в тестах:

$("h1").shouldHave(pseudo(":first-letter", "color", "rgb(255, 0, 0)"));
$("abbr").shouldHave(pseudo(":before", "content", "\"beforeContent\""));
$("abbr").shouldHave(pseudo(":before", "\"beforeContent\""));

А также можно спросить и SelenideElement значение псевдо-элемента (но мы такой способ не приветствуем):

assertThat($("h1").pseudo(":first-letter", "color")).isEqualTo("rgb(255, 0, 0)");
assertThat($("abbr").pseudo(":before")).isEqualTo("\"beforeContent\"");

См. issue 994.
Спасибо Denys Shynkarenko за PR 1045.

Исправили SoftAssertionsExtension для JUnit5

Если один из тестов падал, он помечал и все последующие тесты красным. Упс.

См. issue 1071.
Спасибо Alexei Vinogradov за исправление.

Теперь `$.click()` кликает всегда в ЦЕНТР элемента

В общем, история такая. Метод $.click() обычно кликал в центр элемента, НО если у вас проставлена настройка Configuration.clickViaJS=true, он кликал в левый верхний угол. Не то чтобы это было принципиально важно, но мало ли… Теперь он всегда кликает по центру. На всякий случай. Чтобы всегда всё вело себя одинаково.

См. коммит 106c53941c718.

Новости

Представляете, доклад Алексея Виноградова Selenide: Брандашмыг — интерактивное путешествие по дорогам библиотеки занял 3 место в ТОП-10 докладов Heisenbug 2019 Moscow. Это успех!
Ничего себе! John C. Pratt создал экспортер в Selenide для Katalon Recorder (работает с Katalon Recorder). Это дикий успех!
Обнаружен phpSelenide - порт Селенида на PHP. Это усPHPех!
И если кто ещё не видел, SeleneJS - порт Селенида на JS. Это уех!

Андрей Солнцев

ru.selenide.org

Вышла Selenide 5.7.0

2020-02-07T00:00:00+00:00

Приветос!

Неожиданно нас завалили пуллреквестами с кучей полезных изменений. В этом сила опенсорса!

Мы подбили всё это в кучу и выпустили Selenide 5.7.0.

Мы добавили новую настройку `Configuration.downloadsFolder`

Раньше файлы скачивались в папку build/reports - в ту самую, где генерируются отчёты о прохождении тестов.
А людям иногда хочется разделять (и властвовать?).
Для них мы сделали отдельную настройку Configuration.downloadsFolder - именно туда теперь будут сохраняться файлы.

По умолчанию это папка build/downloads.

См. issue 1025.
Спасибо Dmytro Stekanov за PR 1041.

Скачиваем файлы в `Configuration.downloadsFolder` вместо `~/Downloads`

Со скачиваниями файлов через прокси (Configuration.fileDownload=PROXY) есть ещё одна особенность.
Селенид-то свои файлы скачивает в build/reports (а теперь в build/downloads), но сам-то браузер тоже скачивает свою копию файла в папку ~/Downloads (или что там у него по умолчанию). Во-первых, тратится лишнее место на диске, а во-вторых, оттуда эти файлы никто автоматически не подчищает.

Теперь селенид изначально открывает браузер с такими настройками, чтобы он сразу скачивал файлы в папку build/downloads.

Правда, пока только Chrome и Firefox.
И только в случае, когда селенид сам открывает браузер.

См. issue 1057. Спасибо Dmitri Korobtsov за ревью PR 1058.

Добавили метод для переключения между окнами с кастомным таймаутом

Как вы знаете, в селениде давно есть методы для переключения между вкладками/окнами:

switchTo().window(3);

И этот метод даже настолько умный, что ждёт, пока окно появится. Но для него невозможно было задать таймаут: пресловутые 4 секунды использовались и здесь.

Теперь мы добавили новый метод, в котором вторым аргументом можно задать таймаут для загрузки нового окна:

switchTo().window(3,  Duration.ofSeconds(42));
switchTo().window(3,  Duration.ofMillis(16000));

См. issue 399.
Спасибо Dmytro Stekanov за PR 1054.

Добавили логирование атрибута “readonly”

См. issue 990.
Спасибо Dmytro Stekanov за PR 1042.

Исправили ошибку IndexOutOfBoundsException

… при поиске первого/последнего элемента пустой коллекции

См. issue 991.
Спасибо Dmytro Stekanov за PR 1043.

И целая пачка улучшений скриншотов

1. Вернули потерянные скриншоты в `Screenshots.getLastScreenshot()`

См. issue 814 и issue 880.
Спасибо Petro Ovcharenko за PR 1052.

2. Исправили ссылки на скриншоты в Jenkins

Теперь селенид умеет читать переменную среды (env variable) BUILD_URL, и вам больше не нужно прописывать BUILD_URL в system properties в ваших билд-скриптах.

Спасибо GongYi за PR 1049.

3. Исправили ссылки на скриншоты в Jenkins для мультимодульных проектов Maven

Спасибо GongYi за PR 1049.

Обновились на WebDriverManager 3.8.1

См. changelog (в т.ч. поддержка Edge 80).

Мероприятия

SeleniumCamp 2020

Приезжайте в Киев 21-22 февраля на конференцию SeleniumCamp!
Я буду выступать с двумя докладами:

и ещё будет неформальная сессия BOF про дальнейшие планы развития Селенида.

Митап про Селенид в Германии

Какие-то черти запилили митап про Селенид в Германии 12 февраля.
Приятно, чо.

Статистика

Количество скачиваний селенида за год выросло в 2.5 раза с 40 тысяч до 110 тысяч.

А количество уникальных айпишников перевалило за 20 тысяч:

Мы растём!

Андрей Солнцев

ru.selenide.org

Вышла Selenide 5.6.1

2020-01-14T00:00:00+00:00

Всех с Новым Годом!

Новый год - новый релиз. Встречайте Selenide 5.6.1.

Добавили метод `Selenide.executeAsyncScript()`

Нет такого человека, который ни разу не запускал бы метод Selenide.executeJavaScript(). JavaScript позволяет выйти на новый уровень сумрака в автоматизации.

А теперь мы добавили ещё и метод Selenide.executeAsyncScript(). Правда, я плохо представляю, в каких случаях он может понадобится, но если кому надо - теперь он есть.

Обратите внимание, его использование сложнее, чем обычного executeJavaScript(). После исполнения асинхронного JS кода нужно вызвать callback с результатом. А callback нужно получить из последнего аргумента:

long value = (Long) Selenide.executeAsyncJavaScript(
      "var callback = arguments[arguments.length - 1]; " + 
      "setTimeout(function() { " + 
      "   // Вот тут любая асинхронная чертовщина: " +
      "   ... " +
      "   // и в конце возврат в селениум: " +
      "   callback(10);" + 
      "}, 5000);"
    );
    assertThat(value).isEqualTo(10);

См. issue 1030.
Спасибо Thierry Ygé за PR 1031.

Научили Selenide скачивать через прокси файлы без заголовка `Content-Disposition`

Как вы знаете, Selenide умеет скачивать файлы через свой прокси. Но при скачивании он перехватывал только те ответы сервера, в которых присутствует заголовок Content-Disposition (чтобы узнать оттуда имя скачиваемого файлы).

Как выяснилось, этот заголовок необязателен. Файлы могут скачиваться и без него.

Теперь селенидовский прокси стал умнее.

Прежде чем скачать файл, он ждёт, пока закончатся все предыдущие запросы-ответы между браузером и сервером.
Кликает кнопку скачивания
Перехватывает ВСЕ запросы-ответы между браузером и сервером (вне зависимости от заголовков).
И пытается понять, какой из них больше всего похож на скачивание файла.

А имя файла (в случае ответа без заголовка Content-Disposition) берётся просто из URL.

См. issue 1034 и PR 1035.

Исправили метод `WebDriverRunner.using()`

В октябре мы добавили метод using.
Судя по всему, вы ещё не успели его попробовать, потому что никто не пожаловался на багу: этот метод закрывал вебдрайвер после использования (хотя не должен). Ну вот, эту багу мы исправили.

См. коммит 4d1b19972d.

Обновились на WebDriverManager 3.8.0

там было исправлено несколько ошибок, в т.ч. моего авторства :)

См. changelog.
В частности, WDM теперь должен корректно работать без доступа в интернет.

Новости

Огонь! Selenious - порт селенида на .NET
Ребята обещали, что проект рабочий, они его в реальном проекте используют.
Статья от LambdaTest: Selenide Tests With LambdaTest – Online Selenium Grid For Automated Cross Browser Testing
Моё видео с октябрьской конференции Cyprus Quality Conference Threesome: Selenide for Web, Android and iOS. Не переживайте, в феврале я его буду рассказывать по-русски на SeleniumCamp.
Если кто пропустил, серия постов Selenide Advent Calendar

Андрей Солнцев

ru.selenide.org

Вышла Selenide 5.6.0

2019-12-26T00:00:00+00:00

Всем привет!

Под конец года мы выпустили Selenide 5.6.0 с одним обновлением.

Мы поменяли BrowserMobProxy (который больше не поддерживается) на его форк BrowserUpProxy (текущая версия 2.0.1).

См. issue 1019.
Спасибо Aliaksandr Rasolka за PR 1020.

Что хорошего в этом `BrowserUpProxy`?

Он

Поддерживает Brotli Compression (а не только gzip)
Поддерживает HTTP/2
Основан на поддерживаемом форке LittleProxy
Использует какой-то улучшенный HAR reader
Умеет фильтровать записи в HAR
Поддерживает версионированные заголовки для JSON типа Content-Type=application/something-v1+json
Имеет встроенные ассерты для сетевых запросов (что это вообще?)

Полный список изменений BrowserUpProxy (по сравнению с BrowserMobProxy) есть тут.

Как нам обновиться?

В большинстве случаев вам не придётся ничего менять. Всё работает как работало.
Изменения потребуются только в двух случаях:

1. Если вы явно импортировали BMP, то вам нужно поменять зависимость

net.lightbody.bmp:browsermob-core:2.1.5

на

com.browserup:browserup-proxy-core:2.0.1

2. Если вы определяли `RequestFilter` или `ResponseFilter`,

то вам придётся поменять импорт

import net.lightbody.bmp.*;

на

import com.browserup.bup.*;

И всё.

Новости

Завезли видео с сентябрьской конференции QA Fest:

Андрей Солнцев. Selenide для профи
Андрей Солнцев. Десять причин моей ненависти
И остальные видео QA Fest 2019
Гугловская статья про принципы DAMP и DRY
Ещё один фреймворк на базе Selenide: JustTestLah! (JTL) - Помесь BDD, Selenide, Appium для Android, iOS и Web
Если кто пропустил, серия постов Selenide Advent Calendar

Андрей Солнцев

ru.selenide.org

Трюки с JavaScript

2019-12-24T00:00:00+00:00

Привет!

На дворе 24 декабря, католическое рождество. А это значит, что Advent Calendar подошёл к концу.

И напоследок мы поиграемся с JavaScript.

Как язык JavaScript, конечно, дно, но он даёт большие возможности при написании автотестов.
Он позволяет залезть в такие дыры, куда с обычным вебдрайвером и не снилось.

Приведу несколько примеров из реальных проектов.

Выбрать дату

Есть масса всевозможных элементов для выбора даты - т.н. “date picker”. И выбрать в них нужную дату - это вечная головная боль.

Если реализовывать такой метод в лоб:

@Test {
  setDateByName("recurrent.startDate", "16.01.2009");
}

Придётся сделать примерно следующие шаги:

Тыкнуть иконку “календарик”
Тыкнуть год
Тыкнуть стрелку “месяц назад” (сколько раз?)
Тыкнуть день
Ой, фсё, сегодня 29 февраля. Тест упал.

Долго, сложно, ненадёжно.

А вот как этот метод можно реализовать с помощью JS:

void setDateByName(String name, String date) {
  executeJavaScript(
    String.format("$('[name=\"%s\"]').val('%s')", 
    name, date)
  );
}

Быстро и надёжно.

Возможно, вам смутит, что это не совсем “честный” способ. Но об этом мы поговорим в конце. Не переключайтесь.

Спрятать календарик

Допустим, календарик всё же открылся. Как его спрятать? Решение в лоб - тыкнуть крестик в углу. Опять же, это медленно и ненадёжно:

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

Идиотская ситуация.

А вот как этот метод можно реализовать с помощью JS:

executeJavaScript(
  "$('.datepicker').hide();"
);

Быстро и надёжно.

Перелистнуть перелистывалку

Представим себе страницу, на которой есть “перелистывалка” карт. Нужно выбрать нужную карту, двигая наманикюренным пальчиком.
Как сэмулировать это селениумом?
Можно, конечно. Всякие там Drag’n’Drop, Actions. Нажал, потянул, отпустил. Но всё это медленно и нестабильно.
Это легко может сломаться от малейших изменений дизайна, изменения размерна окна браузера, потери фокуса и т.д.

А вот как можно с помощью JS:

void selectAccount(String accountId) {
  executeJavaScript(
    String.format("$('[data-account-id=\"%s\"]').attr('data-card-account', 'true')", accountId)
  );
}

Это нетривиально. Пришлось поизучать код этой “перелистывалки” и понять, какой JS код она дёргает при перелистывании.
И дёрнуть из теста аналогичный JS код. Придётся поработать головой, но зато это быстро и надёжно.

Выбрать опцию в bootstrap select

Многие UI фреймворки заменяют стандартный <select> на какие-то свои самодельные супер-пупер красивые/динамичные/удобные элементы, сварганенные из нагромождения <div>, <span>, <li> и т.п. с кучей разных CSS-классов и стилей. Для автоматизатора это всегда боль.

Один из таких фреймворков - Bootstrap. И в нём тоже есть свой <select>. Мы долго пытались научиться выбирать из него значения: тыкали на один div, ждали появления следующего span, тыкали на него, искали нужный div с правильными атрибутами… Всё это работало долго и часто падало на дженкинсе. Причин падения так до конца и не удалось понять. Хотя мы честно пытались.

В итоге мы реализовали метод

@Test {
  selectBootstrap($(By.name("operationCode")), "11100");
}

с помощью JavaScript:

void selectBootstrap(WebElement select, String value) {
  executeJavaScript(
    "$(arguments[0]).val(arguments[1]).trigger('change')", 
     select, value);
}

Быстро и надёжно.

А с помощью метода execute это можно написать ещё красивее:

$(By.name("operationCode")).execute(selectBootstrap("11100"));

Слайдер

На странице слайдер. Можно таскать ползунок туда-сюда от 0 до 100.
Как это сделать в тесте?

@Test {
  setMaxYearlyFee(100);
}

Тут даже классический Drag’n’Drop не поможет, потому что нет целевого элемента, куда перетаскивать.
Снова Actions, снова нажал-потянул-отпустил (по координатам?), снова медленно и нестабильно.

А можно с помощью JS:

void setMaxYearlyFee(int value) {
  executeJavaScript(
    "$('#sld').data('slider').value[0] = arguments[0];" +
    "$('#sld').triggerHandler('slide');", 
    value
  );
}

Снова пришлось поковыряться в коде, чтобы узнать, какой JS код дёргает слайдер. Зато работает. Зато быстро и надёжно.

Заигнорить чёртов confirm

В Selenide есть удобные методы, чтобы нажать “Ok” или “Cancel” в модальном диалоге alert, prompt или confirm.
Но с этими модальными окошками периодически возникает проблемы. Иногда они почему-то не закрываются, и после этого вебдрайвер не может ничего сделать с браузером, в том числе снять скриншот. Подробнее об этом я рассказывал в видео Flaky tests.

И снова на помощь приходит JavaScript!

Вот так можно “типа нажать Ok” в любом confirm диалоге:

public void mockConfirm() {
  executeJavaScript(
    "window.confirm = function() {return true;};"
  );
}

Плагины Cordova

В одном проекте мы писали гибридное мобильное приложение с помощью фреймворка Cordova.
Он создаёт такое приложение, в котором очень маленькая нативная часть запускает браузер (т.н. WebView), а в нём уже открывает веб-приложение. А доступ к нативным функциями мобильника (контакты, телефон, геолокация и пр.) предоставляет в виде JavaScript-плагинов.

Это очень удобно для тестирования. Для запуска автотестов не нужны реальные мобильники, достаточно открыть урл в обычном браузере (можно ещё и в режиме эмуляции мобильника - вообще не отличишь).

Но вот как тестировать функционал, требующий доступа к нативным функциям мобильника?

И снова на помощь приходит JS. Мы можем эмулировать плагины Cordova, управляя из теста их поведением:

@Test {
  mockContactsAPI("+79110080075");
}

private void mockContactsAPI(String number) {
  executeJavaScript(
    "window.plugins = {" +
    "  contactNumberPicker: { " +
    "    pick: function(callback) {" +
    "      callback({" + 
    "        phoneNumber:\"" + number + "\""
    "  });}}}");
}

Выражение “управлять поведением” кажется диким? Тогда посмотрите видео Arrange, mazafaka! с конференции SeleniumCamp 2018.

А мы имеем функцию mockContactsAPI, которая позволяет “типа выбрать” нужный номер из “типа адресной книги” “типа телефона”.
Собственно, это единственный способ покрыть тестами все возможные случаи: и когда номер найден, и когда не найден, и когда это дубликат, и с 100500 китайскими символами и бог знает какие ещё. Быстро и надёжно.

Но это же не по-настоящему?

Я знаю, у многих из вас полыхает мысль: “Это же фейк, обман, это не по-настоящему! Тесты должны делать так же, как реальный пользователь - иначе есть риск, что тест не обнаружит реальную ошибку.”

Понимаю.

Но возражу.

Быстрые и надёжные тесты лучше, чем “реалистичные” (но медленные и нестабильные) тесты.

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

То какой к чёрту прок от ваших “настоящих” тестов?
Один вред.

Лучше пусть мои тесты будут быстрыми и стабильными.
И с лёгкостью проверять разные сложные случаи, которые “по-настоящему” повторить нереально.
А я спокойно буду жить с пониманием того, что целью автоматизации никогда и не было автоматизировать абсолютно всё.

Вы всё ещё хотите возразить:

И всё-таки моей душе спокойнее, когда всё по-настоящему.

Спешу вас огорчить.

Ваши “реалистичные” тесты на Selenium WebDriver по-любому не настоящие. Они работают не так, как реальный пользователь. Вебдрайвер формирует http-запрос на каждую вашу команду и даже - вот сюрприз! - запускает некую логику на JavaScript, чтобы определить видимость элементов и т.п.
О да, в некотором смысле вызов действия через JavaScript даже “реалистичнее”, чем через WebDriver. Это ближе к тому, что на самом деле делает браузер.
И даже ваши ручные тестировщики, прокликивающие ваши сценарии - не настоящие! Они работают не так, как реальный пользователь.

Живите теперь с этим. :)

Что теперь?

А всё. Это был последний пост рождественского календаря. Уффф!

Скажу честно: я всё это затеял, чтобы набить руку и приучиться много писать. Надеюсь, это поможет в обновлении сайта и написании документации. А там, глядишь, и до книги дойдёт. :)

Вот такие планы на следующий год.

С наступающим!

Андрей Солнцев

ru.selenide.org

Defaŭlta lingvo

2019-12-22T00:00:00+00:00

Defaŭlta lingvo

Название сегодняшней темы пришло из языка Эсперанто и означает “язык по умолчанию”.

Вы могли заметить, что некоторые веб-приложения и сайты автоматически меняют свой язык в зависимости от настроек вашего браузера или вашего местоположения.

Проблема

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

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

Решение

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

Теперь у вас есть следующие опции:

Поменяйте язык по умолчанию вашей системы. Теперь большинство ваших программ на компьютере заговорят по-немецки. Ordnung muss sein!
Поменяйте в вашем браузере порядок языков так, чтобы самым предпочитаемым стал немецкий. Сохраните профиль браузера. С помощью гугла, напильника и удачи сконфигурируйте тесты так, чтобы профиль загружался перед запуском каждого теста. Да, не забудьте удалить немецкий из топа в списке предпочитаемых языков, иначе, ну вы поняли - Ordnung….
Ну или - просто воспользуйтесь Chrome preference “intl.accept_languages” установив её значение на “de” (немецкий язык).

Разумеется, вы можете легко сделать это в Selenide. Установите значение системной переменной chromeoptions.prefs=intl.accept_languages=de или в коде:

System.setProperty("chromeoptions.prefs","intl.accept_languages=de");

или, лучше, в конфигурационных файлах Maven или Gradle

Maven

maven pom.xml

  ...
  <plugin>
        <artifactId>maven-surefire-plugin</artifactId>
        <version>2.xx.yy</version>
        <configuration>
          <systemPropertyVariables>
            ...
            <chromeoptions.prefs>intl.accept_languages=de</chromeoptions.prefs>
          </systemPropertyVariables>
        </configuration>
    </plugin>
    ...

Gradle

аналогично для Gradle в gradle.properties (вам придётся еще добавить строчку-другую в build.gradle чтобы передать эти параметры в test task грэдла, но про это - в другой раз)

systemProp.chromeoptions.prefs=intl.accept_languages=de

Командная строка

Вы можете переопределять значения при запуске mvn test или gradle test определяя новое значение в -Dchromeoptions.prefs=intl.accept_languages=ru

Пример

Просто запускайте этот маленький тест с различными параметрами языка и понаблюдайте за результатом.

open("http://wikipedia.org");
$("[data-jsl10n=slogan]").shouldHave(exactText("Die freie Enzyklopädie"));

Я желаю всем вам Fröhliche Weihnachten и Guten Rutsch!

Alexei Vinogradov

Теория большого вейта

2019-12-20T00:00:00+00:00

Теория большого вейта

Тема ожиданий вызывает много обсуждений и споров.
Современные веб-сайты создают проблемы для написателей автотестов. Возникает много ситуаций, в которых стандартные методы Selenium неэффективны.

Если вы читали документацию Selenide, вы уже знаете, что классические явные ожидания типа

element = (new WebDriverWait(driver, <timeOutForElement>))
  .until(ExpectedConditions.presenceOfElementLocated(By.cssSelector(<cssSelector>)));

или

element = (new WebDriverWait(driver, <timeOutForElement>))
  .until(ExpectedConditions.visibilityOfElementLocated(By.cssSelector(<cssSelector>)));

были заменены в Selenide более коротким конструкциями типа

element = $(<cssSelector>).should(exist);
element = $(<cssSelector>).shouldBe(visible);

Как известно, ассерты в Selenide - это новая версия явных ожиданий, что хорошо описано в документации.

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

Современные проблемы требуют современных решений

1. `Thread.sleep()`

Это самое ужасное, что может случиться с нашими тестами на Selenium.

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

Если поставить один слип - это ещё ничего. Вы потеряете, скажем, 4 секунды - не смертельно.
Но если вы используете слип в 150 тестах, время их выполнения увеличится заметно.
Нет смысла объяснять, почему это плохо.

Хотя команда sleep() есть и в Selenide, вышеупомянутые “умные ожидания” делают слипы почти ненужными для ожидания появления чего-то либо на странице.
Смотри следующие пункты.

2. Как дождаться окончания загрузки страницы?

Самый простой способ - выбрать какой-то элемент на странице, который редко меняется (скажем, заголовок), и использовать метод Selenide:

$(cssSelector).shouldBe(visible);

Selenide сначала попытается найти элемент, а потом проверить, что он видимый.
Если это не удалось за 4 секунды, вы можете сделать вывод, что страница не загрузилась.

Ещё вы можете выбрать какой-то элемент на предыдущей странице и дождаться, пока он исчезнет:

$(element).should(disappear);

Таким образом мы создаём двойную проверку, что мы перешли с одной страницы на другую. И это будет работать, даже если загрузка страницы занимает значительное время. Как видите, обошлись без всяких Thread.sleep().

3. Изменение состояния элемента

Иногда нам нужно проверить, что состояние элемента поменялось в результате действий пользователя.
Например, элемент может содержать текст, сигнализирующий об успешной или неуспешной загрузке файла.
Допустим, загрузка файла занимает какое-то время, потому что файл большой, или сервер должен запустить какую-то сложную обработку этого файла.

Обычно мы в тесте загружаем файл и проверяем состояние элемента (скажем, текст “файл загружен”).
Но как узнать, когда именно состояние элемента должно поменяться? Загрузка-то происходит не мгновенно.
В этой ситуации многие используют Thread.sleep().

А в Selenide у нас есть умный инструмент для “отложенной” проверки состояния элемента:

$(cssSelector).shouldHave(exactText(<expectedText>));

В этом случае Selenide сам дождётся, пока состояние элемента изменится, и в нём появится нужный текст.
Нам не нужно писать лишних строк для ожиданий, и мы можем быть уверены, что Selenide точно дождётся.

Что теперь?

Мы рассмотрели всего лишь несколько простых идей, как можно “ждать” с помощью Selenide.
В реальности ситуаций намного больше. И здорово, что теперь у нас есть хороший инструмент, позволяющий нам обходится без слипов и не терять драгоценное время.
Используйте умные инструменты и не теряйте время - время ценно. :)

Maciej Grymuza (figrym@gmail.com)

Как получить сетевые запросы с помощью прокси

2019-12-18T00:00:00+00:00

Привет!

В предыдущих постах нашего рождественского календаря мы рассмотрели два способа получить сетевые запросы между браузером и приложением.
Оба нас расстроили тем, что не позволяют прочитать тело запроса/ответа.

Наконец, дошла очередь до третьего способа - через встроенный прокси-сервер.

Перед тестом

Как вы знаете, в селениде уже есть встроенный прокси-сервер, надо его всего лишь включить:

Configuration.proxyEnabled = true;

И ещё нужно сказать прокси-серверу, чтобы он начал отслеживать запросы:

  BrowserMobProxy bmp = WebDriverRunner.getSelenideProxy().getProxy();
    
  // запоминать тело запросов (по умолчанию тело не запоминается, ибо может быть большим)
  bmp.setHarCaptureTypes(CaptureType.getAllContentCaptureTypes());

  // запоминать как запросы, так и ответы
  bmp.enableHarCaptureTypes(CaptureType.REQUEST_CONTENT, CaptureType.RESPONSE_CONTENT);

  // начинай запись!
  bmp.newHar("pofig");

После теста

Теперь нужно получить HAR и анализировать все записи в нём:

    List<HarEntry> requests = bmp.getHar().getLog().getEntries();

HAR (HTTP Archive) - это типа такой “архив” со всеми сетевыми запросами и ответами (“entries”).

Каждая запись - это и есть запрос от тестируемого приложения к серверу.
Внутри есть все данные: URL, request, response, их http status и body.
Всё, о чём мы так давно мечтали.

Плюсы:

Есть все данные, которые нам нужны
Легко анализировать программно
Работает во всех браузерах

Минусы:

Минус только один: иногда у людей возникают сложности с запуском прокси, когда браузер и тесты бегут на разных машинах, и с “браузерной” машины нет доступа к “тестовой” машине. Хотя я никогда не понимал, зачем такие сложности. Запускайте тесты и браузеры на одной и той же машине - ВСЁ будет в стотыщ раз ПРОЩЕ.
Надо параллелить - параллельте тесты. Нужен кластер - запускайте ТЕСТЫ на разных нодах кластера (а с ними запустятся и браузеры). Зачем всё усложнять?

Что теперь?

Теперь мы умеем читать сетевые запросы при прогоне тестов.
Но я вообще-то надеюсь, что обычно это вам не должно быть нужно. Ну может, в каких-то очень уж запутанных случаях.
Обычно должно быть достаточно почитать логи приложения, чтобы понять, какие запросы к нему прилетали. Будьте проще.

Андрей Солнцев

ru.selenide.org

Как получить логи браузера через JavaScript

2019-12-17T00:00:00+00:00

Привет!

В прошлом посте нашего рождественского календаря мы пробовали получить логи хрома с помощью капабилити “goog:loggingPrefs”.
А сегодня попробуем другой способ - с помощью JavaScript.

Итак, надо всего лишь в конце теста дёрнуть такой вот JavaScript:

String js = 
   "var performance = window.performance || window.mozPerformance" +
                   " || window.msPerformance || window.webkitPerformance || {};" +
   " return performance.getEntries() || {};";
String netData = executeJavaScript(js).toString();
logger.info("Network traffic: {}", netData);

Результат получается примерно такой:

Network traffic: [
  {name=https://selenide.org/quick-start.html, connectEnd=0, connectStart=0, decodedBodySize=32582, domComplete=724, domContentLoadedEventEnd=119, domContentLoadedEventStart=115, domInteractive=104, domainLookupEnd=0, domainLookupStart=0, duration=724, encodedBodySize=32582, entryType=navigation, fetchStart=0, initiatorType=navigation, loadEventEnd=724, loadEventStart=724, nextHopProtocol=http/1.1, redirectCount=0, redirectEnd=0, redirectStart=0, requestStart=0, responseEnd=0, responseStart=0, secureConnectionStart=0, serverTiming=[], startTime=0, transferSize=0, type=navigate, unloadEventEnd=10, unloadEventStart=9, workerStart=0},
  {name=https://selenide.org/assets/themes/ingmar/css/styles.css?001, connectEnd=12, connectStart=12, decodedBodySize=8177, domainLookupEnd=12, domainLookupStart=12, duration=29, encodedBodySize=8177, entryType=resource, fetchStart=12, initiatorType=link, nextHopProtocol=http/1.1, redirectEnd=0, redirectStart=0, requestStart=12, responseEnd=41, responseStart=21, secureConnectionStart=0, serverTiming=[], startTime=12, transferSize=0, workerStart=0},
  {name=https://ajax.googleapis.com/ajax/libs/jquery/2.1.1/jquery.min.js, connectEnd=13, connectStart=13, decodedBodySize=84245, domainLookupEnd=13, domainLookupStart=13, duration=28, encodedBodySize=84245, entryType=resource, fetchStart=13, initiatorType=script, nextHopProtocol=http/1.1, redirectEnd=0, redirectStart=0, requestStart=13, responseEnd=41, responseStart=21, secureConnectionStart=0, serverTiming=[], startTime=13, transferSize=0, workerStart=0}
]

Плюсы:

Не нужно никак настраивать браузер. Оно работает из коробки.
Работает во всех браузерах (кажется?)

Минусы:

Здесь всё ещё нет тела запроса.
Это невалидный JSON. Распарсить его стандартным парсером не получится. Придётся придумывать какой-то свой обработчик.

Но этот способ вполне подходит, чтобы просто посмотреть глазами и прикинуть, что происходит.

Что теперь?

Наша последняя надежда - получить запросы и ответы с помощью встроенного прокси-сервера. Этот способ мы рассмотрим в следующем посте.

Андрей Солнцев

ru.selenide.org

Как получить логи браузера

2019-12-16T00:00:00+00:00

Привет!

Мы продолжаем наш рождественский календарь.
На сей раз мы посмотрим, как можно взглянуть хрому под вкладку “developer tools”.
Это на случай, если вы хотите понять, какие ошибки писались и какие сетевые запросы летели из тестируемого приложения во время прогона тестов.

Chromedriver предлагает следующий рецепт.

1. Добавить щепотку строк при открытии браузера:

LoggingPreferences logPrefs = new LoggingPreferences();
logPrefs.enable(LogType.BROWSER, Level.ALL);
logPrefs.enable(LogType.PERFORMANCE, Level.ALL);
capabilities.setCapability("goog:loggingPrefs", logPrefs);

До какой-то версии эта капабилитя называлась “loggingPrefs”, потом переименовали в “goog:loggingPrefs”.
Не знаю, как в других браузерах.

Кстати, помимо BROWSER и PERFORMANCE, есть и другие типы логов, но у меня они как-то нестабильно работали, да я и пользы в них не увидел. Знаете больше? Делитесь!

2. В конце теста снять пенку с логов:

Logs logs = getWebDriver().manage().logs();
printLog(logs.get(LogType.BROWSER));

void printLog(LogEntries entries) {
    logger.info("{} log entries found", entries.getAll().size());
    for (LogEntry entry : entries) {
      logger.info("{} {} {}",
        new Date(entry.getTimestamp()), entry.getLevel(), entry.getMessage()
      );
    }
  }

3. Блюдо подаётся к отчёту примерно в таком виде:

BROWSER logs:

Mon Dec 16 19:29:42 EET 2019 SEVERE http://localhost:9126/page/image/payment-promo-campaign-ozon.png - Failed to load resource: the server responded with a status of 404 (Not Found)
Mon Dec 16 19:49:14 EET 2019 INFO console-api 19:16 "start loading loans"
Mon Dec 16 19:49:14 EET 2019 INFO console-api 21:18 "loaded loans"

Здесь видны все логи, что есть обычно в Developer Tools -> Console. В том числе сообщения console.log и ошибки JavaScript.

4. Для гурманов можно подать десерт

PERFORMANCE logs:

{"message":{"method":"Network.loadingFinished","params":{"encodedDataLength":0,"requestId":"2C9E49BC49DCD3CA6EA9644255E34DE5","shouldReportCorbBlocking":false,"timestamp":141439.076528}},"webview":"FF1A4E4EAAD7143749CD3740DF9BB95F"}
{"message":{"method":"Page.loadEventFired","params":{"timestamp":141439.234207}},"webview":"FF1A4E4EAAD7143749CD3740DF9BB95F"}
{"message":{"method":"Page.frameStoppedLoading","params":{"frameId":"FF1A4E4EAAD7143749CD3740DF9BB95F"}},"webview":"FF1A4E4EAAD7143749CD3740DF9BB95F"}
{"message":{"method":"Page.domContentEventFired","params":{"timestamp":141439.234834}},"webview":"FF1A4E4EAAD7143749CD3740DF9BB95F"}
{"message":{"method":"Page.frameResized","params":{}},"webview":"FF1A4E4EAAD7143749CD3740DF9BB95F"}
...
{"message":{"method":"Network.dataReceived","params":{"dataLength":0,"encodedDataLength":327,"requestId":"58583.71","timestamp":141474.021635}},"webview":"FF1A4E4EAAD7143749CD3740DF9BB95F"}
{"message":{"method":"Network.loadingFinished","params":{"encodedDataLength":586,"requestId":"58583.71","shouldReportCorbBlocking":false,"timestamp":141473.994219}},"webview":"FF1A4E4EAAD7143749CD3740DF9BB95F"}

Плюс

Каждая запись - это валидный JSON, его вполне можно парсить и анализировать прямо в тестах.

Вот так выглядит отформатированная первая запись:

{ 
   "message":{ 
      "method":"Network.loadingFinished",
      "params":{ 
         "encodedDataLength":0,
         "requestId":"2C9E49BC49DCD3CA6EA9644255E34DE5",
         "shouldReportCorbBlocking":false,
         "timestamp":141439.076528
      }
   },
   "webview":"FF1A4E4EAAD7143749CD3740DF9BB95F"
}

Минус:

Что-то понять из этих логов сложно. Нужно строить поверх какие-то анализаторы.
Здесь нет тела запроса.

Что теперь?

В следующий раз вы изучим другие возможности получить логи - со статусами и телами запросов.

Андрей Солнцев

ru.selenide.org

Drag and Drop

2019-12-15T00:00:00+00:00

Привет!

В сегодняшнем выпуске рождественского календаря мы посмотрим короткое, но весёлое видео о том, как перетаскивать элементы в Selenide.

Селенид умеет перетаскивать элементы?

Да, в селениде есть метод Drag’n’Drop. Вот скучное описание из блога селенида:

  $("#from").dragAndDropTo("#to")

А вот весёленькое описание от Martin Škarbala:

Вот это подача!

Андрей Солнцев

ru.selenide.org

Actions

2019-12-12T00:00:00+00:00

Привет!

В сегодняшнем выпуске рождественского календаря мы рассмотрим, как можно использовать “действия” (Actions) в Selenide.

Иногда при написании автотестов мы сталкиваемся со странными проблемами. Уверен на 100%, каждый из нас испытывал или будет испытывать необычные проблемы, которые блокируют нашу работу. Например, у нас часто не получается кликнуть на какой-то элемент, и стандартная селениумовская/селенидовская команда типа

  element.click();

не работает. Причин, по которым клик может не срабатывать - множество. Но мы не можем сдаться просто так, мы должны найти какое-то решение. В Selenium для таких случаев есть класс Actions, который позволяет выполнить клик иначе:

  WebElement element = <Some selector>;
  Actions actions = new Actions(driver);
  actions.moveToElement(element);
  actions.click();
  actions.build().perform();

Этот вариант иногда срабатывает там, где обычный клик бессилен.

Но как сделать это в Selenide?

Оказывается, в Selenide это ещё проще, чем в Selenium (как, собственно, и всё в Selenide :)).
В Selenide тоже есть Actions:

  SelenideElement element = $(<some selector>);
  actions().moveToElement(element).click(element).perform();

Здесь actions() - это один из тех методов, которые вы можете магически подключить волшебным импортом:

  import static com.codeborne.selenide.Selenide.*;

Заметить, чтобы использовать actions(), не нужен webdriver!

Чумачечий drag and drop

Если вы читали документацию, вы знаете, что в Selenide по умолчанию есть два типа операций “drag and drop”:

dragAndDropTo(java.lang.String targetCssSelector);
dragAndDropTo(org.openqa.selenium.WebElement target);

Первый метод перетаскивает элемент в цель по CSS локатору. Второй - в другой WebElement.

Но что, если мы не знаем точно, в какой элемент нужно перетащить?
Допустим, у нас есть просто пустая страница, и мы хотим перетащить несколько объектов в разные места на этой странице.
И тут снова на помощь приходят Actions. В Selenium мы бы сделали это примерно так:

  WebElement element = driver.findElement(By.some);
  Actions actions = new Actions(driver);
  actions.dragAndDropBy(element, xOffset, yOffset).perform();

Где xOffset и yOffset - сдвиг по горизонтали и вертикали.

В Selenide это выглядит чуть короче:

  SelenideElement element = <Some selector>;
  actions().dragAndDropBy(element, xOffset, yOffset).perform();

Таким образом мы можем перетащить элемент в любую точку, даже не зная локатора цели.

Что дальше?

Конечно же, это только пара примеров использования actions() в Selenide, и вы можете экспериментировать и находить другие варианты.

Наслаждайтесь actions()!

Maciej Grymuza (figrym@gmail.com)

Как скачать файл с помощью Selenide

2019-12-10T00:00:00+00:00

Добрый вечер!

На дворе декабрь, и в сегодняшнем посте рождественского календаря Selenide мы поговорим о том, какие возможности для скачивания файлов есть в Selenide.

Как я могу скачать файл в моём тесте?

В какой-то момент нашей карьеры каждый из нас сталкивается с необходимость скачать какой-то файл в тесте.

Как мы помним, в Selenium это было непросто, потому что для разных браузеров требуются разные настройки.
Например, вот так выглядит создание профиля Firefox с нужными настройками:

profile.setPreference("browser.download.dir", downloadPath);
profile.setPreference("browser.download.folderList", 2);
profile.setPreference("browser.download.manager.showWhenStarting", false);
profile.setPreference("browser.helperApps.alwaysAsk.force", false);
profile.setPreference("browser.helperApps.neverAsk.saveToDisk", mimeTypes);
profile.setPreference("browser.download.manager.focusWhenStarting",false);
profile.setPreference("browser.download.manager.useWindow", false);
profile.setPreference("browser.download.manager.showAlertOnComplete", false);
profile.setPreference("pdfjs.disabled", true);

А в Selenide

проблема решается гораздо проще - методом $.download().

Чтобы скачать файл, в Selenide достаточно просто вызвать метод:

File report = element.download();

и Selenide автоматически сделает всё, что надо. Вам не придётся возиться со всплывающим окошком, которое спрашивает, куда сохранить файл, и потом закрывать его.

Selenide сохранит скачанный файл в папку build/reports/tests. Это та же папка, где Gradle генерирует результаты прогона тестов, так что их как раз удобно видеть вместе.

Конечно, поменять эту папку тоже можно:

Configuration.downloadsFolder = <desired location for downloaded files>;

НО:

Таким образом можно скачивать файлы только со ссылкой с атрибутом “href”.

Но что, если у меня ссылки с атрибутом “href”? Так бывает, например, когда файл скачивается в результате сабмита формы. В этом случае можно скачивать файлы с помощью встроенного в селенид прокси-сервера.

Для начала нам нужно включить его (т.к. он по умолчанию выключен):

Configuration.proxyEnabled = true;
Configuration.fileDownload = PROXY;

После этого мы снова можем вызывать метод $.download(), но теперь он стал более могущественным и не требует наличия атрибута “href”:

File report = element.download();

Хозяйке на заметку:

Не забудьте увеличить таймаут, если собираетесь скачивать файл большого размера.

Файл будет скачан в папку по умолчанию (что-то типа C:\downloads and settings\downloads).
Таким образом, скачанный файл окажется в двух местах: c:\downloads... и build/reports/tests.

Если это для вас проблема, можете в конце теста удалить ненужную папку, чтобы очистить место на диске:

FileUtils.deleteDirectory(new File(<папка, подлежащая удалению>));  

Узнать подробнее про механизмы скачивания файлов можно тут.

Maciej Grymuza (figrym@gmail.com)

Почему статики запретили, а потом разрешили?

2019-12-09T00:00:00+00:00

Привет!

9 день рождественского календаря Selenide.
Расскажу о том, что сильнее всего волнует общественность.

Почему статики запретили в 5.0.0, а потом снова разрешили?

Короткий ответ: запретили случайно. Но правильно сделали.

А теперь подробнее.

Коротко о хранении вебдрайверов в селениде

Селенид изначально хранил вебдрайверы в ThreadLocal.
Это позволяет запускать тесты параллельно: в разных потоках - разные вебдрайверы. Код выглядит примерно так:

class WebDriverRunner {
  private static final ThreadLocal<WebDriver> webdriver = new ThreadLocal<>();
  private static final ThreadLocal<SelenideProxyServer> proxy = new ThreadLocal<>();
}

Скажем, метод $("a").click() работает примерно так:

  WebDriverRunner.webdriver.get().findElement("a").click();

Коротко про `SelenideDriver`

Но ThreadLocal накладывает ограничение: ты не можешь использовать в одном потоке два вебдрайвера (а также в двух потоках - один и тот же вебдрайвер, но до этого мы пока не дошли).

Это мы и собирались решить в Selenide 5.0.0. Мы сделали специальный класс SelenideDriver, позволяющий использовать два вебдрайвера в одном тесте:

SelenideDriver browser1 = new SelenideDriver();
SelenideDriver browser2 = new SelenideDriver();

browser1.open("https://google.com");
browser2.open("http://yandex.ru");

browser1.$(h1).shouldHave(text("Google"));
browser2.$(h1).shouldHave(text("Yandeks"));

Для этого пришлось сделать большой рефакторинг, так чтобы внутри самого селенида нигде не использовались старые добрые статические методы open(), $ и $$. Везде, где нужен вебдрайвер, селенид теперь использовал параметр SelenideDriver. Да-да, пришлось его прокидывать во все методы как параметр.

И вот тут главный вопрос

А что делать со старыми добрыми статическими методами open(), $ и $$? Они должны откуда-то взять инстанс SelenideDriver и передать его дальше в кишки селенида. Откуда его взять?

Selenide 5.0.0: Статикам наносят удар

На тот момент этот вопрос решили так (как оказалось, это решение сильно повлияло на ход дел).
В класс WebDriverRunner добавили третий ThreadLocal:

  private static final ThreadLocal<SelenideDriver> selenideDriver = new ThreadLocal<>();

Сам SelenideDriver - это, грубо говоря, очень простой класс с двумя полями WebDriver и SelenideProxyServer.
И в целом всё хорошо работало и решало поставленную задачу.

Чего я не мог предусмотреть на тот момент - это того, что многие люди определяли веб-элементы в статических полях:

public class MyPageObject {
  public static SelenideElement fname = $("#fname");
  public static SelenideElement lname = $("#lname");
}

Да ещё и переоткрывали браузер между тестами.

Важный нюанс:

в Selenide 5.0.0 мы сделали ещё одно улучшение.
Раньше селенид автоматически открывал новый браузер, если его ещё нет, что часто вызывало недоумение, ибо браузер иногда открывался в очень неожиданные моменты (например, при попытке залогировать ошибку, произошедшую из-за закрэшившегося браузера).

Конечно, это происходило из-за плохого кода тестов, но мы же создали селенид, чтобы помогать людям, верно?
Поэтому с версии 5.0.0 селенид стал чётко говорить: “Браузера нет, работать не могу. Вызови сначала метод open(), тогда поговорим.”

И что же свалилось?

Совпадение этих двух факторов привело к следующей проблеме:

Человек создаёт статическую переменную static SelenideElement fname = $("#fname").
Этот fname запоминает, с каким инстансом SelenideDriver он был создан.
Человек в конце теста закрывает браузер
В следующем тесте человек открывает новый браузер и снова обращается к статическому полю fname.
А fname обращается к своему SelenideDriver, с которым он был изначально создан.
И кидает ошибку, потому что тот браузер уже закрылся.

Больше года - с сентября 2018 до октября 2019 - я пытался объяснить всем, что статические переменные - это зло, не надо их использовать.
Сделал даже специально доклад “Антистатик”.

Но в итоге сдался из тех соображений, что слишком много людей, которым пришлось бы переписывать свои тесты. Даже если они согласны насчёт злостности статических переменных, переписать всё - это зачастую неподъёмная задача.
Мы же создали селенид, чтобы помогать людям, верно?

Selenide 5.4.0: Статики победили

Как в итоге решили эту проблему?

Довольно просто. Мы заменили ThreadLocal<SelenideDriver> на статическую переменную (да, вы не ослышались :))

private static final SelenideDriver = new ThreadLocalSelenideDriver();

Теперь наш “статический” SelenideDriver - один на всех. Он никогда не закрывается. Все статические поля, созданные с ним, будут жить вечно. Но он и не хранит в себе поля WebDriver и SelenideProxyServer. Он каждый берёт их из тредлокалов WebDriverRunner.

P.S.

Поэтому в версии 5.4.0 пропал метод WebDriverRunner.getSelenideDriver().

Я очень удивился, что многие люди уже успели его использовать. Люди, я вас не понимаю! Как вы умудряетесь всё так неправильно использовать?
Ок, я не подумав, сделал его публичным. Моя ошибка. Но он не упомянут ни в каких пресс-релизах, ни в какой документации. Как могла кому-то прийти в голову идея его использовать? Как эта магия вообще происходит?

Что теперь?

Мы снова вернули возможность объявлять SelenideElement в статических полях.
Но пожалуйста, не злоупотребляйте этим.
Я всё ещё это не одобряю. :)

Андрей Солнцев

ru.selenide.org

Как протестировать защиту от CSRF атаки

2019-12-07T00:00:00+00:00

Привет!

Сегодня 7 день рождественского календаря Selenide.
И сегодня мы поговорим о тестировании безопасности.

Что такое CSRF?

Одна из самых распространённых атак - это CSRF (Cross-Site Request Forgery), или подделка межсайтовых запросов. Подробно о ней я рассказывал в видосике WTF Security, а сейчас для нас важно то, что защиту от этой атаки легко протестировать вашими обычными автотестами.

Для того, чтобы веб-приложение было защищено от CSRF-атак, с каждым его POST-запросом должен посылаться один хитрый параметр. Он обычно называется authenticityToken (хотя и не обязательно). Когда вы заходите в одной вкладке, скажем, в свой интернет-банк, а в другой вкладке на сайт с котиками, зловредный код на этом сайте может послать POST-запрос вашему банку для совершения платежа на счёт хакера. Хакер может послать счёт и сумму, а также все cookies из вашей вкладки, но он не сможет послать authenticityToken (потому, что он уникальный для каждой сессии и не хранится в cookies).

А типичная ошибка такая: веб-приложение либо не посылает authenticityToken на сервер с каким-то POST-запросом, либо на сервере не проверяет пришедший токен.

Короче, как проверить защищённость?

У вас уже есть куча автотестов, покрывающих весь критичный функционал вашего веб-приложения.
Мы убьём двух зайцев разом: во время запуска этих тестов мы будем перехватывать каждый POST-запрос и посылать точно такой же, но с изменённым authenticityToken. И будем проверять, что сервер вернул ошибку. Обычно это ошибка 403 Forbidden.

Звучит сложно. Как это закодить?

Не так уж сложно.
Как вы знаете, селенид может запускать свой встроенный прокси-сервер. Изначально он использовался для скачивания файлов, но к нему можно добавлять и свои “листенеры”, которые могут перехватывать все запросы между браузером и тестируемым приложением.
Это мы и сделаем.

Шаг 1. Включаем селенидовский прокси-сервер

Configuration.proxyEnabled = true;

(это нужно сделать ДО открытия браузера)

Шаг 2. Добавляем листенер для прокси-сервера

abstract class BaseTest {
  private AuthenticityTokenChecker authenticityTokenChecker = new AuthenticityTokenChecker();

  // и где-то сразу после open("http://..."):
  getSelenideProxy().getProxy().addRequestFilter(authenticityTokenChecker);
}

На данный момент это можно сделать только ПОСЛЕ открытия браузера, что иногда не очень удобно.
Я надеюсь, в следующей версии селенида мы сможем сделать так, чтобы листенеры для прокси-сервера можно было добавлять в любой момент.

Шаг 3. Реализуем AuthenticityTokenChecker

import com.codeborne.selenide.Configuration;
import io.netty.handler.codec.http.*;
import net.lightbody.bmp.filters.*;
import net.lightbody.bmp.util.*;

public class AuthenticityTokenChecker implements RequestFilter {
  private final HttpClient httpClient = HttpClient.newBuilder().build();

  private final List<String> unprotectedUrls = new ArrayList<>(1);

  public void reset() {
    unprotectedUrls.clear();
  }

  public List<String> getUnprotectedUrls() {
    return unprotectedUrls;
  }

  @Override
  public HttpResponse filterRequest(HttpRequest httpRequest, HttpMessageContents contents, HttpMessageInfo httpMessageInfo) {
    if (httpRequest.getMethod() != HttpMethod.POST) return null;                   // игнорируем не-POST запросы
    if (!httpRequest.getUri().startsWith(Configuration.baseUrl)) return null;      // игнорируем запросы хрома к google.com и подобным ресурсами
    if (Этому урлу разрешено и без токена) return null;                            // некоторым post-запросам не требуется защита

    String body = contents.getTextContents();
    if (!body.contains("authenticityToken=")) {
      unprotectedUrls.add("No 'authenticityToken=' found for " + httpRequest.getUri() + " in " + body);
      return null;
    }

    sendHackedPostRequest(httpRequest, contents);
    return null;
  }
}

Обратите внимание: return null; значит “не изменяй запрос”. То есть браузер пошлёт изначальный запрос на сервер без изменений, и нормальное течение вашего теста не будет нарушено.

Шаг 4. Посылаем хакнутый POST-запрос

  private void sendHackedPostRequest(HttpRequest httpRequest, HttpMessageContents contents) throws IOException, InterruptedException {
    // Над этой строчкой придётся поработать. 
    // Формат запроса (и даже имя параметра "authenticityToken") может зависеть от вашего приложения.
    // Обратите внимание, что параметров "authenticityToken" может быть несколько (сразу кидайте ошибку, если они разные).
    // Если в POST-запросе сабмитится форма, да ещё и с файлами, параметр "authenticityToken" придётся выцепить немножко по-другому. 
    String hackedBody = contents.getTextContents()
        .replace("authenticityToken=1234567890").на("authenticityToken=hack-me-if-you-can");

    java.net.http.HttpRequest.Builder builder = java.net.http.HttpRequest.newBuilder()
      .uri(URI.create(httpRequest.getUri()))
      .timeout(Duration.ofSeconds(1));

    for (Map.Entry<String, String> header : httpRequest.headers()) {
      if (!restrictedHeaders.contains(header.getKey().toLowerCase())) {
        builder.header(header.getKey(), header.getValue());
      }
    }

    java.net.http.HttpRequest request = builder
      .POST(java.net.http.HttpRequest.BodyPublishers.ofString(hackedBody))
      .build();

    log.info("Sending hacked request to {}", httpRequest.getUri());

    java.net.http.HttpResponse<String> httpResponse = httpClient.send(request, java.net.http.HttpResponse.BodyHandlers.ofString());

    if (httpResponse.statusCode() == 403) {
      log.info("Hacked request was rejected: {} {}", httpResponse.statusCode(), httpRequest.getUri());
    }
    else {
      log.error("HACK SUCCEEDED {} {}", httpResponse.statusCode(), httpRequest.getUri());
      unprotectedUrls.add("Detected URL without authenticity token check: " + httpRequest.getUri());
    }
  }

  private static final Set<String> restrictedHeaders = Set.of("connection", "content-length",
    "date", "expect", "from", "host", "upgrade", "via", "warning");

Конкретно эта реализация использует HttpClient из Java 11, но если вы из тех бедолаг, что до сих пор сидят на Java 8, вы можете заменить его на OkHttp, Apache Http Client или что-то подобное.

Шаг 5. Валим тест, если нашлись незащищённые запросы

abstract class BaseTest {
  @Before void resetChecker() {
    authenticityTokenChecker.reset();
  }

  @After
  public void verifyThatAllPostRequestsAreProtectedWithAuthenticityToken() {
    if (!authenticityTokenChecker.getUnprotectedUrls().isEmpty()) {
      fail(String.valueOf(authenticityTokenChecker.getUnprotectedUrls()));
    }
  }
}

Что теперь?

Мы убили двух зайцев и научились автоматически проверять защиту от CSRF-атак при запуске наших обычных автотестов.
Это не фантазия, мы реально так сделали на одном проекте и нашли две серьёзных уязвимости в настоящем интернет-банке.

Хорошо, но этого мало. На свете ещё куча атак.

Пересмотрите WTF Security, почитывайте OWASP 10 и мыслите креативно, а как ещё можно убить третьего и четвёртого зайца вашими автотестами.

Андрей Солнцев

ru.selenide.org

Как визуализировать клик

2019-12-06T00:00:00+00:00

Привет!

На дворе 6 декабря, мы продолжаем рождественский календарь Selenide.
И сегодня я покажу один простой способ поймать некоторые нестабильные тесты.

Что не так с кликами?

Вечная проблема - флейки тесты (моргающие, нестабильные).
Одна из типичных причин - клик не срабатывает.
Как я подробно рассказывал в этом видео на DelEx 2019, клик в селениуме часто не срабатывает потому, что элемент в этот момент двигался, растягивался, сжимался, или внезапно появился какой-то другой элемент и перекрыл наш. И клик попал в него.

Почему селенид это уже не решил?

Глобальное решение могло бы быть такое: метод $.click(), перед тем, как кликнуть, сначала ждёт окончания любых движений и анимаций. Но пока в селениде такого нет: я боюсь, что сделать абсолютно универсальную “ожидалку” на все случаи жизни просто невозможно. Проекты разные, UI разный, фреймворки разные, анимации разные. Если у вас есть идеи, как это можно было бы реализовать - обращайтесь, запилим.

А пока нам остаётся делать какие-то свои “ожидалки” в каждом конкретном проекте.

А я хочу показать способ, как узнать, куда клик попал на самом деле. Это не решит проблему полностью, но хотя бы поможет её локализовать.

Как визулизировать клик?

Можно добавить такой вот JS код в своё приложение. Он слушает любые клики на странице, и подсвечивает зелёной рамкой тот элемент, которые реально был кликнут. Это поможет вам на скриншоте упавшего теста понять, что клик попал не в тот элемент, который вам был нужен.

#{if test}
    <script>
      function onClick(event) {
        var e = event || window.event;
        var target = e.target || e.srcElement;
        target.style['box-sizing'] = 'border-box';
        target.style['border'] = '2px solid green';
      }
    
      document.addEventListener('click', onClick);
    </script>
#{/if}

Естественно, приведённый код зависит от вашего фреймворка, приложения, проекта и т.д.
Цвет и толщина рамки - от вашего дизайна. Возможно даже, это должна быть не рамка, а что-то другое.
Главное, чтобы было видно, какой элемент был реально кликнут.

Здесь можно посмотреть один из примеров реализации: Highlighter.

Что теперь?

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

Андрей Солнцев

ru.selenide.org

Как быстро проверить размер?

2019-12-04T00:00:00+00:00

Драсьте!

На дворе 4 декабря, перед вами открыт рождественский календарь Selenide, и в сегодняшнем посте я покажу один простой трюк, как сделать некоторые проверки быстрее.

Как быстро проверить размер коллекции?

В Selenide есть удобные методы для проверки коллекций. Например, вот так можно проверить, что в некотором списке книг ровно три книги:

@Test {
 $$("#books .book").shouldHave(size(3));
}

А если страница реализована так, что в HTML книг больше, а ненужные книги просто прячутся, то можно отфильтровать коллекцию перед проверкой:

@Test {
 $$("#books .book").filter(visible).shouldHave(size(3));
}

Проблема

Если таких книг на странице много (скажем, несколько десятков и больше), то такая фильтрация может быть медленной (скажем, от нескольких секунд и выше). Причина в том, что метод filter(visible) должен вызвать метод WebElement.isDisplayed() в цикле для каждого элемента коллекции по отдельности. А каждый вызов - это отдельное обращение к вебдрайверу, отдельный http запрос и т.д. В сумме накапливается.

Может быть, в вашем проекте тесты бегут трое суток, и несколько секунд погоды не делает. Тогда можете дальше не читать.

Но если вы заботитесь об эффективности ваших тестов, если работаете над их ускорением - мой пост для вас.

Первая попытка

Как можно ускорить эту проверку? Напрашивается первое решение: фильтровать видимые элементы на уровне селектора:

@Test {
 $$("#books .book:visible").shouldHave(size(3));
}

Но так не работает.

Проблема в том, что CSS-селектора :visible не существует. Такую штуку умеет делать только JQuery.

Вторая попытка

Что же нас спасёт?

Вера Брежнева ошибалась: мир спасёт не красота, мир спасёт уродство. И имя ему - JavaScript.

Вы можете создать вспомогательный метод, который с помощью JavaScript и JQuery вернёт количество элементов:

private int sizeOf(String cssSelector) {
  Number count = executeJavaScript("return $(arguments[0]).length", cssSelector);
  return count.intValue();
}

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

И теперь эта проверка будет быстрой, потому что она обратится к браузеру всего один раз. А браузер внутри себя выполняет любые скрипты очень быстро.

@Test {
  assertEquals(1, sizeOf("#books .book:visible"));
}

Что теперь?

Познайте всю мощь JavaScript.
Он позволяет ещё много разных трюков, которые помогут сделать ваши тесты быстрее и надёжнее.

Андрей Солнцев

ru.selenide.org

setWebDriver или WebDriverProvider?

2019-12-03T00:00:00+00:00

Добрый вечер!

На дворе 3 декабря, перед вами открыт рождественский календарь Selenide, и в сегодняшнем посте я отвечу на один простой вопрос.

Что выбрать, `setWebDriver()` или `WebDriverProvider`?

Как вы знаете, Selenide по умолчанию сам открывает и закрывает браузер. Вам для этого ничего не надо делать.

Но иногда вам хочется открыть браузер с какими-то специфичными настройками. Для этого в селениде предусмотрены два разных метода. Так уж сложилось, что я никогда нигде не писал, почему понадобилось два, и как выбрать один из них.

Итак,

Вариант 1:

  Configuration.browser = MyWebdriverProvider.class.getName();

Этот вариант предпочтительнее в большинстве случаев. Он хорош тем, что ваш класс MyWebdriverProvider отвечает только за то, КАК открыть браузер (какие ключики ему передать, где найти бинарник, вот это всё). Но не отвечает за то, КОГДА открыть и закрыть браузер. Об этом заботится селенид.

Вариант 2:

@Before
public void setUp() {
  var yandexBrowser = new YandexDriver(...);
  WebDriverRunner.setWebDriver(yandexBrowser);
}

Этот вариант хуже тем, что вам придётся самому не только открывать, но и закрывать браузер. Это часто вызывает недопонимание. Селенид не может его закрыть, ведь он не знает, где ещё вы можете его использовать. Сам открыл - сам закрывай.

Отсюда назревает вопрос:

А зачем он вообще нужен?

Честно говоря, я сам долгое время не отдавал себе в этом отчёт, и лишь недавно назрело понимание. :)

Изначально метод setWebDriver() был добавлен для того, чтобы людям было легко перевести на селенид существующие проекты (не переписывая весь проект).

Представьте, что в компании X уже есть стотыщ автотестов на селениуме (или HtmlElements, Thucydides, Serenity или чём-то ещё). И они хотят новые тесты писать на селениде, а старые не трогать. Работают и работают.

И у них где-то в тестах уже есть код, которые открывает и закрывает браузер. И хотелось бы как-то сказать селениду, чтобы он тоже этот браузер использовал. Вот для этого и подходит метод setWebDriver(). Он позволяет запускать и старый, и новый код вперемежку, так чтобы они работали с одним и тем же браузером и не мешали друг дружке.

То есть применение у метода setWebDriver(), как вы видите, довольно узкое. Я вообще не уверен, использовали ли его вообще хоть когда-нибудь в таком ключе.

Что теперь?

А если вы пишите новый проект, используйте WebDriverProvider. SRP.

UPD

Позже в Selenide 5.16.1 появилась более новая возможность - DriverFactory. Теперь это рекомендованный способ создавать кастомный вебдрайвер.

По сути она очень похожа на WebDriverProvider, но даёт больше контроля над происходящим. Вам нужно

либо реализовать интерфейс DriverFactory,
либо создать подкласс ChromeDriverFactory, FirefoxDriverFactory или другого похожего класса (которые есть в составе Selenide и реализуют интерфейс DriverFactory) и переопределить лишь нужные методы. Все методы в них специально сделаны маленькие и объявлены как protected.

Примеры есть в тестах самого селенида.

См. также этот пост от Boris Bay.

Андрей Солнцев

ru.selenide.org

Как надругаться над Селенидом

2019-12-02T00:00:00+00:00

Всем привет!

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

Как надругаться над Селенидом

(и почему это у многих вызывает трудности)

Я часто получаю жалобу, что у людей не ловится ошибка вот в таком коде:

try {
  $(".banner").shouldBe(visible);
  $(".banner .close").click();
}
catch (Exception e) {
  // System.out.println("Элемент не найден - значит, баннер в этот раз не появился");
}

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

Почему это плохой тест?

Потому, что он медленный.

В большинстве случае баннер не появится, и тест будет ждать 4 секунды (или какой у вас таймаут).

Это ужасно. Вы профессионалы или кто? Ваша цель - сделать тесты быстрыми и надёжными. Иначе чем вы отличаетесь от обезьяны?

Почему это очень плохой тест?

Потому, что он нестабильный.

Иногда баннер будет появляться как раз на истёке 4 секунд. Тест решит, что баннера нет, и пойдёт дальше, а тут оп! - и выскочит баннер. И вы получаете “моргающий” тест.

Почему это очень-очень плохой тест?

Потому, что он не тестирует сам баннер.

Представьте себе, что за время прогона тестов баннер так ни разу и не появился. Все тесты зелёные. А у реальных пользователей баннер появляется, и как раз тогда случается ошибка. И всё крэшится. Пользователи жалуются и обрушивают рейтинг вашего приложения.

А ваши тесты зелёные.
Или наоборот, во время прогона тестов баннер появляется постоянно. Ну вот так сложилось в тестовой среде. А у реальных пользователей баннер появляется редко, и как раз без баннера случается ошибка. Всё крэшится. Пользователи жалуются и обрушивают рейтинг вашего приложения.

А ваши тесты зелёные.

Что же делать?

Очевидно, что у вас должно быть как минимум два теста:

Случай, когда баннер выскакивает, и
Случай, когда баннер не выскакивает.

Значит, у вас должна быть возможность как-то управлять показом баннера. Либо через “ручку” (api) тестируемого приложения, либо через какую-то админку, либо запуском SQL в базе. Как угодно. Если такой ручки нет, надо пойти договориться с разработчиками.

Только не надо мне говорить, что договориться не получится. Вы профессионалы или кто?

Если не получится, то стирайте весь этот тест. Не получилось так не получилось.

Подробнее про ручки и управление тестовой средой см. в докладе Arrange, mazafaka!

И наконец, на десерт:

Почему ошибка не ловится?

Вы уже догадались, почему ошибка не ловится?

Всё дело в иерархии исключений в Java. Базовый класс не Exception, а Throwable.

Throwable
- Exception
  - RuntimeException
    - WebDriverException
- Error
  - AssertionError
    - UIAssertionError
      - ElementShould

Именно поэтому, когда вы ловите catch (Exception e), мимо вас пролетают все подклассы Error, в том числе все селенидовские ошибки.

“Ну отлично, буду ловить catch (Error e)” - решите вы. НЕТ! Прошу вас, НЕТ!

Читаем javadoc к классу java.lang.Error:

An Error is a subclass of Throwable that indicates serious problems that a reasonable application should not try to catch. Most such errors are abnormal conditions.

Что теперь?

Я надеюсь, вы перестанете ловить ошибки в тестах. Тесты для того и созданы, чтобы сообщать об ошибках, а не ловить их.

Надеюсь, вы посмотрите Arrange, mazafaka! и возьмёте управление тестовой средой под свой контроль.

И решите для себя, тварь вы дрожащая, или право имеете?

Андрей Солнцев

ru.selenide.org

Selenide

Вышла Selenide 6.13.0

Поддержка баннеров

Проблема

Стадия принятия

Как это работает

Альтернативные методы

Кастомный обработчик

News

Вышла Selenide 6.12.4

Костыль для Хрома

Добавили поддержку jdk-http-client вместо netty-client

Исправили работу прокси после метода using

Исправили $.clear() при пропадании элемента

Обновили зависимости

Выпустили selenide-appium:2.7.0

Выпустили selenide-selenoid:2.3.6

News

Вышла Selenide 6.12.2

В чём проблема?

Вышла Selenide 6.12.0

Новый безбашенный режим

Улучшили логирование при скачивании файлов

Улучшили скачивание файлов в Edge под Windows

Обновили зависимости

Переименовали ветку master в main

News

UPD Вышла Selenide 6.12.1

UPD Вышла Selenide 6.12.2

UPD Вышла Selenide 6.12.3

Вышла Selenide 6.11.1

Обрезаем только сообщения WebDriverException

Чутка подправили $.download(FOLDER)

Обновили зависимости

News

Статистика

Вышла Selenide 6.11.0

С Новым Годом, друзья!

Добавили методы для копирования текста

Исправили метод Selenide.download(url)

Позволяем скачивать большие файлы через прокси

Можно обрабатывать неожиданные алерты

Исправили пермиссии файла скриншота

Поддержка аннотации @As для полей без @FindBy

Метод для последнего сохранённого исходника страницы

Теперь можно добавлять URL страницы в сообщение об ошибке

Итоги года

И всё-таки

Вышла Selenide 6.10.2

Всем привет!

Добавили метод $.press()

Генерируем события change в методах $.select*

Показываем $.selectOption() в отчётах по-человечески

Показываем localStorage в отчётах по-человечески

Обновили зависимости

Дочерние проекты

Новости

Вышла Selenide 6.10.0

Недобрый вечер!

Улучшили алгоритм скачивания файлов

Ускорили отрицательное скачивание файла

Выбираем опции в <select> через JavaScript

Сделали $.click(options) “чейнебл”

Исправили размер окна для новых вкладок

Поддерживаем логин/пароль BasicAuth со спецсимволами

Обновили зависимости

Дочерние проекты

Новости

Мои свежие видосы

Видосы и читосы

Статистика

Вышла Selenide 6.9.0

Привет!

Научили прокси подменять ответ сервера

Пример

Тест

Детали

Ограничения

В общем

Посылаем заголовок авторизации только нужному домену

Добавили поддержку `jdk-http-client` вместо `netty-client`

Исправили работу прокси после метода `using`

Исправили `$.clear()` при пропадании элемента

Выпустили `selenide-appium:2.7.0`

Выпустили `selenide-selenoid:2.3.6`

Переименовали ветку `master` в `main`

Обрезаем только сообщения `WebDriverException`

Чутка подправили `$.download(FOLDER)`

Исправили метод `Selenide.download(url)`

Поддержка аннотации `@As` для полей без `@FindBy`

Добавили метод `$.press()`

Генерируем события `change` в методах `$.select*`

Показываем `$.selectOption()` в отчётах по-человечески

Показываем `localStorage` в отчётах по-человечески

Выбираем опции в `<select>` через JavaScript

Сделали `$.click(options)` “чейнебл”

Убрали `getAlias` из отчётов

Добавили метод `page()`, не требующий параметр `Class`

Добавили аннотацию `@As`

Добавили настройку `remoteReadTimeout`

Добавили условие `partialValue`

Добавили условие `tagName`

Проверяем, что элемент - `<select>`

Исправили плагин `full-size-screenshot`

Теперь `$.shouldHave(text)` может проверять текст целиком

Отменили аннотацию `@Report`

Починили `$.setValue()` в IE

Сделали публичным `HttpClientTimeouts`

Вернули тип параметра `String` для `$.setValue()`

Добавили короткие варианты для вызова `$.click`