Selenide

Вышла Selenide 7.6.0

2024-11-24T00:00:00+00:00

Всем привет!
Мы выпустили Selenide 7.6.0 с чем-то вкусненьким и интересненьким.
Йоу-йоу, погнали обновляться!

Видосики — вещь серьезная.
Если есть видосики, значит они что-то отражают.

Что нового:

Добавили видео рекордер
because для условий вебдрайвера
метод $.scrollIntoCenter()
Поддержка специальных пробелов
Исправили inNewBrowser с кастомной конфигурацией
Исправили аппиумскую пэдж фактори
Уменьшили количество селенидовских логов
Подправили поведение Selenide.screenshot(filename)
JSR305 -> JSpecify
Упростили кастомные команды
Обновили зависимости
Новости
Статистика

Добавили видео рекордер

А вот наконец-то!

У всех бывают нестабильные тесты. Моргающие тесты. Flaky tests.

Если эта тема для вас в новинку, я вам завидую. Вас ждёт увлекательное погружение в
Flaky Tests
Flaky Tests 2
Flaky tests. Порядок имеет значение
Flaky tests. Метод

Так вот, при расследовании моргающих тестов очень помогают видосики. И теперь Селенид умеет их делать из коробки.

Когда-то мы много пользовались библиотекой VideoRecorder от Сергея Пирогова, и она же позволила мне сделать все вышеупомянутые доклады. Но теперь Сергей собирает дроны для ВСУ и опенсорсом временно не занимается.
Такие времена. :(

Как начать записывать видосы?

Просто

Замените зависимость selenide:7.6.0 на selenide-video-recorder:7.6.0
Повесьте на ваши тесты расширение org.selenide.videorecorder.junit5.VideoRecorderExtension (в случае JUnit5)
Повесьте на ваши тесты листенер org.selenide.videorecorder.testng.VideoRecorderListener (в случае, прости господи, TestNG)
Повесьте аннотацию @Video на нестабильные тесты (их ведь немного?)

Теперь селенид начнёт записывать видосы для всех помеченных тестов.
НО
сохранять видос будет только в том случае, если тест упал. Ссылка на видео будет автоматически добавлена к сообщению об ошибке - так же, как ссылка на скриншот.

Element should have text "Орешник"
Actual value: text="Кокошник"

Screenshot: file:/.../build/reports/tests/1732761758509.0.png
Page source: file:/.../build/reports/tests/1732761758509.0.html
Video: file:/.../build/reports/tests/1732761754743.0.webm

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

В начале каждого помеченного теста Селенид запускает два потока:

Регулярно снимает скриншоты браузера и складывает в очередь (пока в памяти)
Сливает скриншоты из очереди в видео (используя библиотеку org.bytedeco:javacv)

В конце теста видео либо удаляется, либо сохраняется в файл и прикрепляется к сообщению об ошибке.

P.S. Это поведение и некоторые параметры можно настраивать в файле selenide.properties, см. VideoConfiguration.

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

См. issue 2145. Спасибо Sergey Brit за PR 2768,
Также см. PR 2890 с аннотациями-конфигурациями.

Добавили `because` для условий вебдрайвера

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

webdriver().shouldHave(numberOfWindows(2)));
webdriver().shouldHave(url("https://dictionary.cambridge.org")));

а с пояснением:

webdriver().shouldHave(
  numberOfWindows(2).because("Логин должен открыться в новом окне"));

webdriver().shouldHave(
  url("https://dictionary.cambridge.org/").because("WTF is Oreshnik?"));

Спасибо Daniil Moiseev за PR 2853.

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

По сути это то же самое, что $.scrollIntoView("{block: 'center'}"), просто короче.
Ведь в большинстве случаев, когда мы скроллим, мы хотим именно этого.

  $("#logout")
    .scrollIntoCenter()
    .shouldHave(text("Мутная кнопка где-то внизу экрана"))
    .click();

См. PR 2842.

Поддержка специальных пробелов

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

До сих пор Селенид трактовал таким образом несколько пробельных символов (<space>, <tab>,  , <newline>). Но оказалось, что различных извращённых пробелов гораздо больше (т.н. “En Space”, “Em Space”, “Three-Per-Em Space” и т.д.). Теперь мы их всех умеем игнорировать. :)

Например, для такой вот веб-странички:

<div id="hero">
  Аху &#32; &nbsp; &ensp; &emsp; &numsp; &NoBreak; &puncsp; 
  &ThinSpace; &VeryThinSpace; &MediumSpace; Дарьяи
</div>

Будет работать такой тест:

  $("#hero").shouldHave(text("Аху Дарьяи"));

  $(byText("Аху Дарьяи")).ancestor().shouldHave(
    text("Произнесите её имя и расскажите её историю."));

Спасибо Daniil Moiseev за PR 2858.
Также см. PR 2884.

Исправили `inNewBrowser` с кастомной конфигурацией

Это редко используется, так что не заморачивайтесь. Но для отчётности надо упомянуть.

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

inNewBrowser(Config config, Runnable lambda)

Во-вторых, исправили старый метод inNewBrowser(Runnable lambda), если внутри него использовалась кастомная конфигурация (в этом случае при закрытии браузера предыдущая конфигурация не восстанавливалась).

См. issue 2859 и PR 2902.

Исправили аппиумскую пэдж фактори

Исправили багу в selenide-appium, когда тест пытался создать не мобильный, а обычный вебовский пэдж обжект. Причём до того, как веб-браузер открыт.

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

Уменьшили количество селенидовских логов

Мы пересмотрели логи, которые пишет Selenide, и превратили некоторые “info” логи в “debug”.
Другими словами, теперь в логах должно быть меньше спама.
Если понадобится отлаживать какую-то сложную проблему, включайте уровень “debug”. ;)

См. PR 2892.

Подправили поведение `Selenide.screenshot(filename)`

У него в javadoc было написано, что он сохраняет оба файла - “.html” и “.png”. А на самом деле сохранял только “*.png”. Теперь поведение соответствует описанию.

См. issue 2896 и PR 2901.

JSR305 -> JSpecify

Многие селенидовские методы помечены аннотациями @Nullable, @Nonnull, @CheckReturnValue, @ParametersAreNonnullByDefault.
Это чтобы вам их легче было использовать, и IDE подсказывала вам какие-то типичные косяки:

  $("h1");   // Упс, кто-то забыл проверку: .shouldBe(visible)

Так вот, до сих пор эти аннотации мы брали из библиотеки “JSR 305” (соответственно, аннотации импортировали из пакета javax.annotation).
Но эта библиотека уже давно не поддерживается. А недавно ей на замену выпустили новую библиотеку JSpecify. И Селенид перешёл на неё. Теперь аннотации импортируются из пакетов org.jspecify.annotations и com.google.errorprone.annotations.

См. PR 2889.

Упростили кастомные команды

Если вы создавали свой подкласс от Click, SetValue или других селенидовских команд, то мы вам случайно поломали обратную совместимость. Прастите. :)

Теперь вместо метода

public SelenideElement execute(SelenideElement proxy, WebElementSource locator, Object [] args) { ... }

вам нужно будет имплементировать метод

protected void execute(WebElementSource locator, Object @Nullable [] args) { ... }

Но так ведь короче и проще, правда же?

Но в целом, если у вас проект компилируется, то не парьтесь, вас это не касается. :)

См. issue 2906 и PR 2889.

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

bump Selenium from 4.25.0 to 4.26.0 (incl. CDP 129 -> 130)
Bumps BrowserUpProxy from 2.2.19 to 3.0.0.
Bump LittleProxy from 2.3.0 to 2.3.2
Bump Netty from 4.1.113.Final to 4.1.115.Final
Bump Guava from 33.3.0-jre to 33.3.1-jre
Bump JUnit from 5.11.0 to 5.11.3
Bump Jackson from 2.17.2 to 2.18.1
Bump HttpClient from 5.4 to 5.4.1

Новости

Статья Чего вы не знали о Selenide от Serhii Bryt
Обзор Selenide 7.5.1 от Borys Yevstyhneiev
Пишем тесты с Selenide - Демо-занятие курса «Java QA Engineer. Professional»
Сравниваем Selenium и Selenide: что выбрать? от Inzhenerka.tech
Как написать автотест за 10 минут на Selenide? от Дмитрий Ярыгин
Погружение в Selenide
UI Testing with Selenide в блоге Oril, см. Видео туториал
новенький адаптер для Selenide, см. проект на гитхабе
Selenide — практикум
Selenide. Знакомство и написание тестов
Selenide-Java от Victor Hugo Fonseca

Статистика

Количество скачиваний побило новый рекорд - 1.3 миллиона за октябрь!

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

ru.selenide.org

Вышла Selenide 7.5.0

2024-09-15T00:00:00+00:00

Давно не виделись, котаны!

Последний пресс-релиз я писал в апреле. С тех пор мы выпустили несколько релизов, из которых самый объёмный - 7.4.0.

Но теперь по-любому пора обновиться на Selenide 7.5.0:

Открывать браузер с новой конфигурацией
Починили события в селектах
Укоротили API для скачивания файлов
Больше не закрываем окна при скачивании файлов
Больше не ловим вообще все ошибки
Починили кастомные обработчики ошибок
Обновили зависимости
Новости
Статистика

Можно открывать браузер с новой конфигурацией

В Селениде есть один нюанс, неочевидный для начинающих: все настройки в классе Configuration - статические. Поменяешь настройку в одном тесте - она повлияет на остальные. Особенно это важно при запуске параллельных тестов.

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

$.click(usingJavaScript()); // вместо Configuration.clickViaJs = true
$.download(using(PROXY)); // вместо Configuration.fileDownload = PROXY

Подробнее об этом процессе я рассказывал здесь.

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

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

@Test void testWithoutProxy() {
  open("/one", new SelenideConfig().proxyEnabled(false).fileDownload(FOLDER));
  File report = $("#report").download();
}

@Test void testWithProxy() {
  open("/two", new SelenideConfig().proxyEnabled(true).fileDownload(PROXY));
  File cv = $("#cv").download();
}

Смотрите не злоупотребляйте.

NB! Когда вы вызываете метод open(url, config), а какой-то браузер уже открыт в этом потоке (предыдущим тестом), то селенид его закроет. Это может привести к замедлению ваших тестов из-за постоянного переоткрывания браузеров. Имейте в виду.

См. issue 1372 и PR 2846.

Починили события в селектах

В Selenide 7.4.2 мы улучшили работу с селектами в Vue.js: стали кидать события input в дополнение к change. Но при этом мы случайно изменили сами события: они больше не “bubbleable”. Что сломало обработку селектов в каких-то других фреймворках (когда обработчик события change висит не на самом селекте, а на его родителе).

В общем, теперь починили. Смело выбирайте опции в ваших любимых селектах любыми способами:

$("#migrants").selectOption("Похищают домашних животных");
$("#migrants").selectOptionContainingText("дят собак и кош");
$("#migrants").selectOption(2);
$("#migrants").selectOptionByValue("kill-ducks-from-parks");

См. issue 2832 и PR 2835.

Укоротили API для скачивания файлов

Чтобы скачать файл с расширением “.txt”, раньше надо было написать довольно длинное выражение:

File f = $.download(using(FOLDER).withFilter(withExtension("txt")));

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

import static com.codeborne.selenide.DownloadOptions.file;

File f = $.download(file().withExtension("txt")));

В целом алгоритм прост: пишешь download(file(). - и после точки выскакивают доступные варианты.

См. PR 2841.

Больше не закрываем окна при скачивании файлов

Тут вот какая история. В селениде есть 4 метода скачивания файлов (HTTPGET, FOLDER, PROXY, CDP), и два из них (FOLDER, PROXY) изначально работали по такому принципу:

Кликает элемент
Ждёт, пока появится новый файл
Если после клика появилось новое окно/вкладка - закрывает его
Возвращает файл

И вот сейчас мы пришли к пониманию, что третий шаг вроде как и не нужен. Никто уже и не помнит, зачем он изначально был добавлен. ¯_(ツ)_/¯

Теперь селенид не будет пытаться закрыть никаких окон. Если у вас с этим проблема - обращайтесь, обкашляем вопросик. :)

См. issue 2836 и PR 2840.

Больше не ловим вообще все ошибки

И снова ломаем устои. :)
Главный алгоритм Селенида - это по сути try/catch внутри цикла (до достижения 4 секунд). И очень важный вопрос - какие именно ошибки ловить внутри этого try/catch.

Много лет там стояло catch (Error error). По всем канонам - плохая практика в Java. Никто уже точно не помнит, почему. Возможно, из-за Internet Explorer, который когда-то кидал java.lang.Error в случае невалидного XPath.

А проблема в том, что этот catch (Error error) может скрывать серьёзные проблемы, при которых тест должен не ретраить в цикле, а сразу падать. Что-то в духе OutOfMemory error.

В общем, теперь мы не ловим Error и надеемся, что ни у кого ничего не сломается, ибо Internet Explorer давно показывает веб-странички Пригожину и Кобзону.

См. PR 2845.

Починили кастомные обработчики ошибок

Ой, пофиг, лень расписывать. :)
Если вы переопределяете класс SelenideErrorFormatter, читайте issue 2830 и PR 2839.

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

bump BrowserUpProxy from 2.2.18 to 2.2.19
bump dnsjava from 3.6.0 to 3.6.1
bump LittleProxy from 2.2.4 to 2.3.0 (#2837)

Новости

Мой видос How to migrate from Selenium to Selenide for more stable tests! с SeleniumConf 2024
Мой видос Selenide: Enjoy Writing Automated Tests for Mobile & Web с Testμ 2024 (LambdaTest)
Мой видос How to debug autotests с конференции EpicHey 2023
Статьё Selenium or Selenide: Which Testing Framework Best Fits Your Needs?
Статьё Test smells: cleaning up E2E tests by Natalia Poliakova, Mikhail Lankin
Видос про Селенид на испанском! by Jose Diaz
И ещё на турецком! by Ahmet Bayram Ders
Введение Selenide для QA Auto. Что такое Selenide? на канале QA Automation и SDET
То же, вид из шортов
И наконец-то про коммиты на английском: WTF Commit messages

Статистика

Количество скачиваний побило новый рекорд - 1.154.002 за август!

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

ru.selenide.org

Вышла Selenide 7.3.1

2024-04-28T00:00:00+00:00

Добро утро!

Мы выпустили Selenide 7.3.1.

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

Мокать ответ сервера заданного типа
Исправили метод $.clear() в мобилках
Исправили сообщение при клике на некорректную ссылку
Отключили предупреждение Хрома про сворованные пароли
Исправили загрузку файлов через CDP для кастомных вебдрайверов
Задеприкейтили настройку holdBrowserOpen
Обновили Selenium с 4.19.1 до 4.20.0
Статистика

Мокать ответ сервера заданного типа

Как вы помните, Селенид позволяет через прокси подменить ответ сервера:

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

Но при этом невозможно было задать тип контента (xml, json и т.п.). А иногда это важно. Теперь можно задать любые заголовки для ответа сервера, в т.ч. Content-Type:

import org.openqa.selenium.remote.http.HttpResponse;

getSelenideProxy().proxyMocker().mockResponse("cik-mock", 
  urlStartsWith(GET, "https://cik.ru/api/gov/no/referendum"), () -> new HttpResponse()
      .setStatus(429)
      .addHeader("Content-Type", "application/json")
      .setContent(utf8String("{votes: 2133326, for: 99.23, against: 0.77}"))
  );

См. issue 2705 и PR 2706.

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

… для элемента, который существует, но невидим.

Оказывается, что вызов clear или click в мобилках:

$("#hiddenElement").clear();

Падал с некорректным сообщением, если элемент найден, но невидим (например, перекрыт другим элементом):

Element should be interactable {By.name: ComputeSumButton}
Element: '<XCUIElementTypeButton ... visible="false">...

Caused by: 
  UnsupportedCommandException: 
    Unhandled endpoint: /session/28...13/element/07000000-0000-0000-CF35-000000000000/css/opacity ...

Теперь сообщение будем корректным, без всяких там UnsupportedCommandException:

Element should be visible {By.name: ComputeSumButton}

См. issue 2722 и PR 2723.

Исправили сообщение при клике на некорректную ссылку

Похожая проблема. Если в Firefox попытаться кликнуть на некорректную ссылку (например, https://zopa):

  $("#invalid-link")
    .shouldHave(attribute("href", "https://zopa"))
    .click();

то Селенид выдавал некорректное сообщение об ошибке:

Element not found {#link}
Expected: clickable: interactable and enabled

Теперь будет честный текст ошибки:

WebDriverException: Reached error page: about:neterror?e=dnsNotFound&u=https%3A//zopa/
                    Build info: version: '4.20.0', revision: '866c76ca80'

P.S. Интересно, что такую ошибку выдаёт только Firefox. Остальные браузеры спокойно показывают стандартную страницу с текстом:

This site can’t be reached
Check if there is a typo in example.
DNS_PROBE_FINISHED_NXDOMAIN

См. issue 2725 и PR 2727.

Отключили предупреждение Хрома про сворованные пароли

Снова. Уже отключали в PR 2662, но там мы добавили настройку profile.password_manager_enabled=false, и этого оказалось мало. Теперь докинули ещё и настройку profile.password_manager_leak_detection=false.

См. PR 2729.

Исправили загрузку файлов через CDP для кастомных вебдрайверов

Как вы помните, несколько месяцев назад вы реализовали новый способ скачивания файлов через CDP. Работает он только в Chromium-based браузерах (Chrome, Edge etc.).

Но вот в случае кастомного вебдрайвера проверка “а хром ли это” не срабатывала:

Configuration.fileDownload = CDP;
Configuration.browser = MyCustomChromedriverFactory.class.getName();

File report = $("#report").download();
// летела ошибка: java.lang.IllegalArgumentException: 
// The browser you selected "MyTest$CustomWebDriverProvider" doesn't have Chrome Devtools protocol functionality.

Теперь селенид правильно распознаёт Chromium-based браузеры по их реальным капабилитям. Обожаю это слово. :)

Спасибо Petr Ovcharenko за PR 2728.

Задеприкейтили настройку `holdBrowserOpen`

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

Лично мне никогда не нравилась эта фича, и я давно хотел её удалить. Но теперь появилась веская причина: внезапно мы осознали, что фича вредная. Когда вы поковыряетесь в браузере и закроете его руками, вебдрайвер-то никто уже не закроет, и он останется висеть в памяти и жрать ресурсы.

Поэтому вместо holdBrowserOpen лучше напишите где-нибудь в своём тесте sleep(600_000) и ковыряйтесь на здоровье.

Кто знает, почему именно 600 секунд? Олды тут?

См. PR 2730.

Обновили Selenium с 4.19.1 до 4.20.0

В ченджлоге Selenium, честно говоря, больших изменений не вижу. Ну разве что добавили поддержку CDP 124 и убрали 121.

См. PR 2726.

Статистика

Случилось!!!

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

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

ru.selenide.org

Вышла Selenide 7.2.0

2024-02-27T00:00:00+00:00

Чёртов февраль.

Чтобы хоть как-то отвлечься, попробуйте обновиться на Selenide 7.2.0:

Скачиваем файлы из Selenium Grid
Скачиваем файлы удалённо с помощью CDP
Коллекции элементов для мобилок
Выключили предупреждение хрома про покраденные пароли
Сообщение об ошибке, если нет href
Обновили Selenium с 4.17.0 на 4.18.1

Скачиваем файлы из Selenium Grid

Наконец-то!
Теперь вы можете скачивать файлы методом FOLDER и из Selenium Grid.
До сих пор FOLDER работал только при локальном запуске и в Selenoid.

Если вы гоняете браузеры на Selenium Grid и хотите в тестах скачивать файлы методом FOLDER, вам просто нужно будет поменять зависимость

  com.codeborne:selenide:7.1.0

на

  com.codeborne:selenide-grid:7.2.0

И как бы в общем-то всё.

Configuration.remote = "https://qa.grid.my.com:4444/wd/hub";
Configuration.fileDownload = FOLDER;
File quotes = $("#quotes").download(withExtension("txt"));
assertThat(quotes.content()).contains(
  "Любовь сильнее страха",
  "Стыдно не делать ничего. Стыдно дать себя запугать.");

См. issue 1687, PR 2659 и PR 2660.

Скачиваем файлы удалённо с помощью CDP

В предыдущем релизе мы добавили новый метод скачивания файлов CDP, но работал он только локально.

Теперь он также работает с удалёнными браузерами на Selenoid и Selenium Grid.

Configuration.remote = "https://cloud.browsers.my.com:4444/wd/hub";
Configuration.fileDownload = CDP;
File places = $("#places").download(withExtension("csv"));
assertThat(places.content()).contains("Утоли моя печали", "Борисовское");

См. issue 1687, issue 2550 и PR 2661.

Коллекции элементов для мобилок

Мы навалили полезняшек для автотестов мобильных приложений. Появились новые методы для коллекций:

SelenideAppium.$$(By)
SelenideAppium.$$(Collection<WebElement>)

Оба возвращают объект SelenideAppiumCollection. По сути это то же самое, что старый добрый ElementsCollection, только с объектами SelenideAppiumElement вместо SelenideElement.

SelenideAppiumCollection poetry = $$(By.xpath("//android.widget.EditText")).shouldHave(size(2));
poetry.get(0).scroll(up()).setValue("и в небо сорвутся тромбы");
poetry.get(1).scroll(down()).setValue("багровых кремлёвских башен");

Также добавили метод SelenideAppium.$(WebElement webElement), но вряд ли это вам пригодится.

См. issue 2333 и PR 2656.

Выключили предупреждение хрома про покраденные пароли

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

И хотя это выглядит скорее как бага Chrome 122, мы на всякий случай его по-быстрому вырубили.

См. issue 2658 и PR 2662.

Сообщение об ошибке, если нет `href`

Меня внезапно осенило, почему так много людей мучаются с настройкой прокси и даже не догадываются, что в селениде есть и другие способы скачивания файлов: FOLDER и CDP (которые проще в использовании, а теперь ещё и полноценно работают с удалёнными браузерами).

Возможно, проблема в коммуникации. Все эти годы метод $.download() кидал вот такую ошибку:

The element does not have href attribute: <a id="generate-report">

После этого люди гуглили первую попавшуюся статью 5-летней давности, в которой, конечно, упоминалась только одна альтернатива - PROXY. И ломились изучать прокси.

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

The element does not have "href" attribute: <a id="generate-report">, so method HTTPGET cannot download the file.
Please try another download method: FOLDER, CDP or PROXY.
Read more about possible download methods: https://selenide.org/javadoc/current/com/codeborne/selenide/FileDownloadMode.html

Правда, боюсь, это не поможет, потому что кто же их читает-то…

См. PR 2653.

Обновили Selenium с 4.17.0 на 4.18.1

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

Будем надеяться на весну.

Не сдавайтесь.
Не унывайте и не опускайте руки.
Автоматизация тестирования — это не спринт, а долгий тяжёлый марафон.

Теперь далеко отсюда

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

ru.selenide.org

Вышла Selenide 7.1.0

2024-02-07T00:00:00+00:00

Всем привет! С Новым Годом, с новыми надеждами!

Сегодня у нас в меню свеженький блестящий Selenide 7.1.0:

Скачивание файлов с помощью CDP
Условие animated
IF с таймаутом ¯¯_(ツ)_/¯¯
Можно кликать задизейбленные элементы
Метод $.unfocus()
Исправили page load timeout в мобилках
Можно добавлять прокси фильтр многократно
Обновили зависимости
Статистика

Скачивание файлов с помощью CDP

Не прошло и три года, как в Selenium завезли CDP, а мы уже сделали с помощью него скачивание файлов! Как вы знаете, скачивать файлы в селениде можно несколькими способами: HTTPGET, FOLDER, PROXY. Теперь к ним добавился ещё и CDP:

Configuration.fileDownload = CDP;
File f = $.download();

либо

File f = $.download(using(CDP));

Работает он примерно как FOLDER: кликает ссылку и ждёт, пока файл появится в списке скачанных. Только в отличие от FOLDER, CDP понимает, что загрузка завершена, не по дате файла, а по событию Browser.downloadProgress из CDP.

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

См. issue 2550. Спасибо Sergey Brit за PR 2567.

NB! Как контрибьютер, Сергей получает право рассказать вам о каком-то фонде на его выбор.

Слово Сергею:

Призываю вас донатить фонду ANGRY CORGI.

Фонд Angry Corgi создан людьми из tech, чтобы усилить компьютерную инфраструктуру частей ПВО и ряду других частей Сил Обороны Украины.
Фонд постоянно принимает технику из разных стран мира, а также собирает деньги на закупку планшетов, телевизоров и другого коммуникационного оборудования.

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

Условие `animated` для окончания анимации

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

Подробнее об этом в видосе Flaky tests.

Теперь можно дождаться окончания анимации с помощью такой вот команды:

  $.shouldNotBe(animated);

Надеемся, это поможет сделать ваши тесты более стабильными.

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

Вы спросите, а как же селенид понимает, что анимация закончилась? Загляните в пулреквест, это интересно. Если вкратце - с помощью JS функции requestAnimationFrame селенид спрашивает у браузера размеры и координаты элемента два раза подряд (в двух разных циклах отрисовки) и проверяет, что они не изменились. Хитро, а?

Добавили IF с таймаутом ¯¯_(ツ)_/¯¯

Много лет мы сопротивлялись, но всё-таки позволили этому случиться. :)

Мы добавили метод $.is(condition, timeout), который возвращает boolean. Теперь в своих тестах вы сможете писать ифы без try/catch. Ворота в ад разверзлись.

  if ($("#banner").is(visible, Duration.ofSeconds(2))) {
    $("#banner .close").click();
  }

Логика этого ифа наверняка подпалит немало седалищ, так что будьте внимательны:

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

См. issue 2590.
Вечный позор на мои седины за PR 2640!

NB! Новый метод $.is(.., Duration.ofSeconds(8)) может быть медленным! Результат false он всегда возвращает через 8 секунд! Это же убийственно долго для тестов. Постарайтесь не использовать такие проверки.

Можно кликать задизейбленные элементы

Начиная с версии 6.15.0, селенид не позволяет кликнуть на disabled элемент. Но иногда это бывает надо (например, проверить, что клик по такому элементу ничего не делает). Теперь можно обойти все проверки и тупо кликнуть на какой угодно элемент с помощью параметра force:

  $("#disabledButton").click(usingDefaultMethod().force());

Не злоупотребляйте.

См. issue 2635 и PR 2636.

Метод `$.unfocus()`

Мы добавили метод $.unfocus(), который убирает фокус с элемента.

В общем-то это можно было сделать и раньше с помощью $.pressTab(), но у него могут быть нежелательные сайд-эффекты. Например, другой элемент неожиданно окажется в фокусе. А иногда по нажатию на TAB и вовсе сабмитится форма (например, при вводе OTP-кода).

А метод $.unfocus() в этом смысле безопасен: он просто убирает фокус с элемента. И вы можете проверить, что сработало автозаполнение, форматирование, подсказка и т.п.

  $("#card-number").sendKeys("1111-222-33-4444").unfocus();
  $("#preview").shouldHave(text("Pay to 1111-***-**-***4 ?"));

См. issue 2638 и PR 2639.

Исправили page load timeout в мобилках

Был у нас маленький косячок, из-за которого мы случайно выставляли Configuration.pageLoadTimeout в мобильных тестах. А Appium такую настройку не поддерживает. Из-за чего вы могли видеть такие логи:

NotImplementedError: Not implemented yet for pageLoad

Некритично, это всего лишь warning. Но больше вы его не увидите.

См. issue 2612 и PR 2628.

Можно добавлять прокси фильтр многократно

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

  private static final RequestFilter REQUEST_LOGGER = new RequestFilter() {...}

  @BeforeEach
  final void setUp() {
    getSelenideProxy().addRequestFilter("request-logger", REQUEST_LOGGER);
  }

Раньше селенид ругался, что такой фильтр уже есть. А теперь будет спокойненько работать дальше (но только если это реально тот же самый фильтр).

См. issue 2617 и PR 2630.

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

bump JUnit from 5.10.1 to 5.10.2
bump TestNG from 7.8.0 to 7.9.0
Bump slf4jVersion from 2.0.11 to 2.0.12
Bump LittleProxy from 2.1.1 to 2.1.2

Статистика

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

Вау.

И ещё один занимательный график.

Есть у Селенида один подпроект selenide-appium для написания автотестов для мобилок. Раньше он не особо пользовался спросом (по сравнению с самим Селенидом), но в этом году резко попёр вверх.

Не знаю, чем это объясняется, но это круто. :)

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

ru.selenide.org

Вышла Selenide 7.0.1

2023-10-26T00:00:00+00:00

Вчера мы выпустили Selenide 7.0.0 и, честно говоря, я ожидал волны жалоб насчёт Java 17.

Но нет. На Java 17 никто пока не жаловался. И это здорово! Все обновили джаву, все молодцы.
Но зато люди очень просили обратно циклы по коллекциям.

Так и быть, в сегодняшнем Selenide 7.0.1 мы кое-что вернули:

Вернули циклы по коллекциям
Вернули метод isEmpty() у коллекций
Вернули поле self в контейнерах
Переименовали CollectionCondition в WebElementsCondition
UPD 7.0.2: Обновились на Selenium 4.15.0

Вернули циклы по коллекциям

Теперь вы можете снова использовать for по коллекциям:

for (SelenideElement element : $$(".element")) {
  element.shouldBe(visible);
}

А я не устану повторять, что

НЕ НАДО ТАК ДЕЛАТЬ!

Не используйте циклы и условия в тестах!

Если вы хотите собрать в кучу тексты или атрибуты всех элементов, чтобы потом и проверить, то для этого есть т.н. “collection condition”:

  $$(".errors").shouldHave(texts("One", "Two", "Three"));

  $$("#numbers option").shouldHave(attributes("value",
                   "one", "two", "three", "four", "five"));

А если вы не нашли готовой проверки под ваши нужды, легко можете написать свою. Просто создайте класс от WebElementsCondition и реализуйте в нём метод check. Ну изи же. И сможете его переиспользовать в куче своих тестов.

См. PR 2533.

Вернули метод `isEmpty()` у коллекций

Мне по-прежнему непонятно - зачем, но зачем-то люди используют этот метод:

  boolean errorsFound = $$(".error").isEmpty();

См. PR 2533.

Вернули поле `self` в контейнерах

В релизе 7.0.0 мы удалили класс ElementsContainer, а с ним пропал и метод getSelf(). Я всё ещё нахожу его странным, но почему-то люди его используют.

Если это про вас, то вы можете заменить метод getSelf() на поле с аннотацией @Self:

static class RadioButton implements Container {
  @Self
  SelenideElement label;

  @FindBy(tagName = "input[type=radio]")
  SelenideElement input;
}

См. PR 2534.

Переименовали `CollectionCondition` в `WebElementsCondition`

Вас это коснётся, только если вы писали самодельные проверки для коллекций.

Не беда, просто поменяйте extends CollectionCondition на WebElementsCondition.

См. issue 2372 и PR 2533.

UPD 7.0.2: Обновились на Selenium 4.15.0

Позже мы выпустили Selenide 7.0.2 с обновлением на последний Selenium 4.15.0

Тут ченджлог селениума.

См. PR 2540.

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

ru.selenide.org

Вышла Selenide 7.0.0

2023-10-25T00:00:00+00:00

С днём рождения!

Да-да, в этот день 12 лет назад был сделан первый коммит в проекте Selenide. Если интересно, здесь видос моего рассказа к 10-летию селенида.

К празднику мы выпустили мажорный релиз Selenide 7.0.0 с обновлением аж сразу на Java 17.

Обновились на Java 17
Обновили зависимости
Дедлок при инициализации классов
Актуальное значение на момент проверки
Удалили старые методы в Condition
Удалили старые методы в CollectionCondition
Удалили старые методы в ElementsCollection
Заменили ElementsContainer на Container
Заменили FileNotFoundException на FileNotDownloadedError
Переименовали *Exception в *Error
Удалили поддержку устаревшего WebDriverEventListener
Удалили старые методы для Drag’n’drop
Удалили устаревшие методы $.getSelectedValue() и $.getSelectedText()
Удалили старые аннотации для TestNG @Report и @GlobalTextReport
Остальное

Обновились на Java 17

Чума! Этот день настал!

Чтобы использовать Selenide 7.+, вам придётся компилировать и запускать тесты на Java 17+.

Как же это круто, да?

Я знаю, среди вас найдутся те, кому это решение не понравится. Вы всё ещё вынуждены гонять тесты на Java 8.

Но мы не виноваты. Как вы знаете, Selenium 4.14+ перешёл с Java 8 на Java 11. Так что продолжать жить с Java 8 у вас всё равно не получилось бы. Обновиться на Java 11 всё равно пришлось бы. Ну а дальше простое соображение: самое сложное обновление как раз с Java 8 на Java 11. А вот с Java 11 на Java 17 обновиться намного проще. Там и делать-то ничего не надо.

Так что обновляйтесь смелее!

Жизнь слишком коротка, чтобы продолжать мять титьки с Java 8

См. PR 2522.

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

Обновили Selenium с 4.13.0 на 4.14.1 (PR 2505) - требует Java 11+
Обновили Appium с 8.6.0 на 9.0.0 (PR 2505) - требует Java 11+
Обновили TestNG с 7.4.0 на 7.8.0 (PR 2505) - требует Java 11+

Исправили дедлок при инициализации классов

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

Подробнее про static initialization deadlock можно посмотреть в видосе Перформансные войны.

При этом нам пришлось переименовать базовый класс для всех проверок из Condition в WebElementCondition.

Не пугайтесь, все ваши импорты типа Condition.visible останутся без изменений.
А вот если вы написали свои самодельные проверки, то в них надо будет заменить extends Condition на extends WebElementCondition.

См. issue 2372 и PR 2453.

Актуальное значение на момент проверки

Тут идёт речь не о классических проверках веб-элементов, а о проверках “нового поколения”: url, localStorage и т.п.

webdriver().shouldHave(url("https://some.com/page.html"));
localStorage().shouldHave(item("mouse", "Jerry”));
sessionStorage().shouldHave(itemWithValue("mouse", "Jerry”));
clipboard().shouldHave(content("Лох, Антилохово, Шалава, Мусорка, Пуково, Попки и Бухалово"));

В общем, мы сделали сообщение об ошибке более корректным. За деталями можно сгонять в issue 2500 и PR 2501.

Удалили старые методы в `Condition`

Удалили методы apply() и actualValue() в классе Condition. Они уже давно были помечены как @Deprecated.

Вас это коснётся, только если вы писали свои самодельные проверки. Теперь вместо двух методов apply() и actualValue() вам нужно будет реализовывать лишь один метод check.

См. PR 2512.

Удалили старые методы в `CollectionCondition`

Аналогично предыдущему пункту, если у вас есть самодельные проверки для коллекций (extends CollectionCondition), то в них вместо методов test и fail надо будет реализовать один метод check.

См. PR 2520.

Удалили старые методы в `ElementsCollection`

Боюсь, тут будет много чего подгорать. :) В общем, теперь ElementsCollection больше не наследует java.util.List. Изначально это наследование случайно привнесло в ElementsCollection кучу ненужных методов (таких, как remove(), removeRange, clear, subList или listIterator()), которые никогда не планировалось реализовывать. Но пользователи иногда использовали. И даже иногда жаловались на хабре, что они не так работают.

Ну вот, теперь нет методов - нет проблем.
В $$ остались только те методы, которые мы считаем нужными. Аминь.

P.S. Если у вас есть цикл по элементам коллекции:

  for (SelenideElement el : $$("#selenide-users .user")) {
    el.shouldBe(visible);
  }

то он перестанет компилироваться.

Быстрое решение - добавить к нему asFixedIterable():

  for (SelenideElement el : $$("#selenide-users .user").asFixedIterable()) {
    el.shouldBe(visible);
  }

Но правильное решение - переписать код и избавиться от цикла. Скорее всего вам стоит написать свой collection condition.

См. PR 2513.

UPD С версии 7.0.1 снова компилируется.

Заменили `ElementsContainer` на `Container`

Если вы вычленяли куски ваших пэдж обжектов в отдельные переиспользуемые компоненты (или “виджеты”), то они обычно наследовали класс ElementsContainer:

class WeatherWidget extends ElementsContainer {
  @FindBy(id = "air")
  private SelenideElement airTemperature;
}

Теперь надо будет заменить ElementsContainer на просто Container:

class WeatherWidget implements Container {
  @FindBy(id = "air")
  private SelenideElement airTemperature;
}

При этом пропадает метод getSelf(), который очень давно уже был @Deprecated. Но если он вам всё ещё нужен, в Selenide 7.0.1 ему изобрели замену в виде аннотации @Self.

См. PR 2523.

Заменили `FileNotFoundException` на `FileNotDownloadedError`

Раньше многие методы типа $.download() были объявлены как throws FileNotFoundException. И вам приходилось страдать, добавляя этот бессмысленный throws FileNotFoundException и в свои тесты. Теперь можно будет подчистить этот хлам и убрать ненужные catch (FileNotFoundException), если они у вас были.

Теперь методы типа $.download() будут кидать FileNotDownloadedError, который является AssertionError, и его не надо ни объявлять, ни ловить. Если тест не смог скачать файл - тест должен упасть. Никакой дополнительной обработки не требуется.

См. PR 2526.

Переименовали некоторые `Exception` классы в `Error`

Лично я не думаю, что это хоть сколько-нибудь важно.
Но религия некоторых пользователей запрещает им называть класс *Exception, если он не наследует класс java.lang.Exception.

Ну что ж, вы уважаем все религии. Теперь селенидовские классы, наследующие java.lang.Error, будут называться *Error.

В Украине. Блогерка. Молдова. Беларусь. Таллинн.

Нам несложно.

См. issue 2485 и PR 2530.

Удалили поддержку устаревшего `WebDriverEventListener`

Мы удалили все методы типа addListener() с параметром типа org.openqa.selenium.support.events.WebDriverEventListener.

Этот класс уже давно был помечен как @Deprecated в селениуме.

Используйте вместо него addListener() с параметром org.openqa.selenium.support.events.WebDriverListener.

См. PR 2516.

Удалили старые методы для Drag’n’drop

Очередная чистка. Просто замените

$("#what").dragAndDropTo(where);

на

$("#what").dragAndDrop(to(where));

См. PR 2519.

Удалили устаревшие методы `$.getSelectedValue()` и `$.getSelectedText()`

И ещё чистка.

Замените $.getSelectedValue() на $.getSelectedOptionValue()
Замените $.getSelectedText() на $.getSelectedOptionText()

См. PR 2521.

Удалили старые аннотации для TestNG `@Report` и `@GlobalTextReport`

Эти аннотации были не нужны, начиная с Selenide 6.7.0. Просто удалите их. Да и TestNG удалите, чего уж там. ;)

См. PR 2517.

Остальное

Замените

new BearerTokenCredentials("pwd")

на

new BearerTokenCredentials("domain", "pwd")

Замените

$.should(appears);

на

$.should(appear);   //  или просто $.shouldBe(visible)

Замените

Selenide.open(url, BASIC, "username", "password");

на

Selenide.open(url, BASIC, new BasicAuthCredentials("username", "password"));

См. PR 2518.

Навстречу прогрессу!

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

ru.selenide.org

Вышла Selenide 6.19.1

2023-10-18T00:00:00+00:00

Всем привет!

Мир замер в ожидании, грядут большие изменения!
Скоро будет Selenide 7.0.0 с обновлением на Java 11.

Эпоха Java8-лямбдовых куколдов проходит

А напоследок мы выкатили последнюю версию, которая может ещё бегать на Java 8:

Selenide 6.19.1

В основном там обновления зависимостей, в первую очередь Appium 8.6.0:

bump Appium from 8.5.1 to 8.6.0 (#2494)
Bump BrowserUpProxy (#2510)
Bump Netty from 4.1.98.Final to 4.1.100.Final (#2484) (#2498)
Bump LittleProxy from 2.0.21 to 2.0.22 (#2491)
Bump Guava from 32.1.2-jre to 32.1.3-jre (#2499)
Bump Jackson from 2.15.2 to 2.15.3 (#2502) (#2503)
Bump commons-io from 2.13.0 to 2.14.0 (#2486)

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

ru.selenide.org

Вышла Selenide 6.19.0

2023-09-28T00:00:00+00:00

Всем привет! На излёте сентября вы выкатили Selenide 6.19.0.

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

Новый метод `$.highlight()` для подсветки элемента

Чувствую, открываем очередной ящик Пандоры, но что поделать.

В общем, мы добавили метод для подсветки элемента.

Зачем это надо?

Честно говоря, незачем. :)

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

Как именно он подсвечивается?

На данный момент есть два варианта подсветки: цветным фоном (по умолчанию) или рамкой.

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

$("h1").highlight();              // по умолчанию - background()
$("h1").highlight(background());  // цветной фон
$("h1").highlight(border());      // цветная рамка

Фону и рамке можно задать свои стили:

$("h1").highlight(background("rgb(85, 180, 250);"));
$("h1").highlight(border("3px solid blue"));

А можно и задать полностью крафтовый стиль для выделения элемента:

$("h1").highlight(style("color: white; background-color: red;"));

Дальнейшее развитие

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

В общем, делитесь идеями, будем думать.

См. issue 1277, issue 2395 и PR 2481.

Убираем невидимые пробелы в текстах коллекций

Как вы помните, в Selenide 6.16.0 мы ускорили работу с коллекциями с помощью вставок JavaScript кода. Оказалось, что при этом мы чуть изменили поведение для элементов, содержащих невидимые пробелы и прочие хитрые символы.

Допустим, у нас на страничке есть такой элемент:

<div id="status">
  <span> Боевой дух</span>
  <span>  ипучая&nbsp;\u200Bдействительность  </span>
</div>

И раньше проверка типа

$$("#status span").shouldHave(texts("Боевой дух", "ипучая действительность"));

падала:

Expected :[Боевой дух, ипучая действительность]
Actual   :[Боевой дух, ипучая действительность]

Причём выглядит сообщение так, как будто тексты одинаковые. Но в первой строке - обычный пробел, а во второй - невидимый пробел “”.

Теперь же селенид будет вычищать такие невидимые пробелы. Правильно это или нет, можно спорить, но так велит нам стандарт WebDriver, и так работает Selenium. И мы тоже будем соответствовать.

См. issue 2469 и PR 2482.
Спасибо Maksim Au6ojlut за подсказку с чёртовыми пробелами.

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

Обновили Selenium с 4.12.1 на 4.13.0
Вот тут его ченджлог.

Несколько важных багфиксов, но всё ещё бегает на Java8. Ловите, пока он не стал требовать Java 11+! ;)

См. PR 2479.

Убрали строгую проверку на “/wd/hub”

Если вы используете Selenoid, то раньше плагин selenide-selenoid проверял, чтобы URL заканчивался строкой /wd/hub. Оказалось, что URL бывает и другим, и поэтому мы эту проверку убрали.

См. issue 2475.
Спасибо Dmitry Plodukhin за PR 2476.

Заменили класс `ElementsContainer` на интерфейс `Container`

Как вы помните, недавно мы запретили пэдж обжектам наследоваться от ElementsContainer.

Такой вариант больше не работает:

class LoginPage extends ElementsContainer {
}

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

class LoginPage implements Container {
}

Для обычных виджетов тоже рекомендуется поменять extends ElementsContainer на implements Container.

Разница только в том, что это интерфейс, а не абстрактный класс (надо писать “implements” вместо “extends”), и в нём не будет метода getSelf(). Ну и не надо.

См. issue 2439 и PR 2465.

Добавили методы `$.tap()`, `$.doubleTap()` для мобилок

import static com.codeborne.selenide.appium.SelenideAppium.$;

$(By.name("ComputeSumButton")).tap();
$(AppiumBy.xpath("//android.widget.Button")).doubleTap();
$(AppiumBy.xpath(".//*[@text='Лютая арта']")).tap(longPressFor(ofSeconds(4)));

Спасибо qwez за PR 2467.

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

import static com.codeborne.selenide.appium.AppiumSelectors.byClassNameAndIndex;
import static com.codeborne.selenide.appium.SelenideAppium.$;

$(byClassNameAndIndex("android.widget.TextView", 7)).tap();

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

Новости

Selenium logger - новый проект от Titus Fortner
Introduction to Selenide - Исторический момент! Пост на легендарном сайте Baeldung.
Selenide appium - Видос с последней конференции LambdaTest от Amuthan Sakthivel
Selenide test automation: using Selenoid in docker by Dora & Margarita
Things to keep in mind when using Selenide - пост на японском от nilwurtz
Intro to Selenide By Updates4Devs.com
Non-static Selenide: пробуем жить с selenide-core и что это нам даст - интересная нетривиальная тема от Дмитрий Тучс
Почему наследование в автотестах это антипаттерн? - пост (не про Selenide) от Ruslan Galliamov

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

ru.selenide.org

Вышла Selenide 6.18.0

2023-09-06T00:00:00+00:00

Все уже перевернули календарь?
Тогда при свете костров рябин можете обновиться на Selenide 6.18.0.

Показываем актуальные тексты в коллекциях

В релизе 6.16.0 мы ускорили проверки коллекций.

$$(".troubles").shouldHave(texts(
  "Всё не то", "всё не так", 
  "ты мой друг", "я твой враг"));

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

List size mismatch: expected: = 4, actual: 3

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

Поэтому с этого релиза будем показывать и размер, и тексты:

List size mismatch (expected: 4, actual: 3)
Actual (3): [Журавлей белый клин, твоя дочь, и мой сын]
Expected (4): [Всё не то, всё не так, ты мой друг, я твой враг]

См. issue 2434 и PR 2456.

Обновили Selenium с 4.11.0 на 4.12.1

Ченджлог здесь. Среди прочего, там исправили злополучный дедлок в devtools, из-за которого нам пришлось выпустить предыдущий релиз.

См. PR 2452.

Вернули BasicAuth через DevTools

В релизе 6.16.0 мы запилили авторизацию BasicAuth через механизм HasAuthentication в браузерах семейства Chromium.

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

См. issue 2336, PR 2358 и PR 2452.

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

В селениде уже был метод $$.getSelectedOptions() - он возвращает выбранные опции элемента <select>. А теперь мы добавили похожий метод $$.getOptions(), чтобы можно было проверить все его опции.

$("select").getOptions()
  .shouldHave(texts("день прощанья", "костры рябин", "обещания"));

$("select").selectOption("день прощанья");

$("select").getSelectedOptions()
  .shouldHave(texts("день прощанья"));

См. issue 2445 и PR 2446.

Метод `getFocusedElement()` обленился

Теперь метод getFocusedElement() возвращает SelenideElement, а не WebElement.

Что автоматически означает ленивую загрузку и прочие плюшки.
А ещё вы можете использовать для него стандартные should-проверки:

Selenide.getFocusedElement()
  .shouldHave(tagName("input"), id("otpCode"));

См. PR 2454.

Добавили поддержку полей `SelenideAppiumElement` в пэдж обжектах

Если вы пишете тесты для мобилок с нашим плагином selenide-appium, то теперь вы можете объявлять поля пэдж обжекта с типом SelenideAppiumElement, вместо SelenideElement.

Это даёт дополнительные методы для мобилок: hideKeyboard(), swipe() и т.п.

class LoginPage {
  @AndroidFindBy(accessibility = "Username input field")
  SelenideAppiumElement login;

  @AndroidFindBy(accessibility = "Password input field")
  SelenideElement password;
  
  public void login() {
    password.swipeTo();
  }
}

См. issue 2437 и PR 2438.

Точечный скроллинг в мобилках

Продолжая тему мобилок. В плагине selenide-appium есть метод scroll:

import static com.codeborne.selenide.appium.AppiumScrollOptions.with;

$.scroll(with(UP, 20)); // свайпать вверх, не больше 20 раз

А теперь ему в параметрах можно более точно указать начальную и конечную точку свайпа (в процентах от высоты экрана):

import static com.codeborne.selenide.appium.AppiumScrollOptions.up;

$.scroll(up(10, 80)); // свайпать от точки 10% до точки 80%

Спасибо qwez за PR 2449.

Нельзя наследовать пэдж обжект от `ElementsContainer`

Некоторые пользователи жаловались на такой вот странный ворнинг от селенида:

WARN com.codeborne.selenide.impl.SelenidePageFactory - Cannot initialize field private com.codeborne.selenide.SelenideElement com.codeborne.selenide.ElementsContainer.self

Мы начали исследовать тему и поняли, что это происходит, если вы наследуете пэдж обжект от ElementsContainer:

class LoginPage extends ElementsContainer {
}

Что на самом деле не нужно. Собственно, теперь и не получится. :)

Изначально ElementsContainer был задуман для того, чтобы объявлять компоненты внутри пэдж обжекта:

class LoginPage {
  @FindBy(id="weather")
  WeatherWidget weatherWidget;
}

class WeatherWidget extends ElementsContainer {
  @FindBy(id="temperature")
  SelenideElement temperature;
}

Просто уберите extends ElementsContainer из своего пэдж обжекта, и всё будет прекрасно работать.

P.S. Дело в том, что это разные объекты с разной судьбой.

Пэдж обжекты вы можете создавать методом LoginPage page = Selenide.page();. И для этого им не требуется наследоваться от ElementsContainer.
А вот поля этих пэдж обжектов надо наследовать от ElementsContainer, чтобы селенид знал, что в них надо тоже искать аннотации @FindBy.

См. issue 2439 и PR 2455.

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

bump LittleProxy from 2.0.19 to 2.0.20 (fixes a memory leak in Selenide proxy)
update vulnerable jackson dependency - см. PR 2442

Статистика

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

Такими темпами у нас будет всё всерьёз. Следующего второго сентября.

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

ru.selenide.org

Вышла Selenide 6.17.2

2023-08-24T00:00:00+00:00

Добрий вечір!

Сегодня 24 августа - День Независимости Украины.
И в честь этого праздника - маленький релизец Selenide 6.17.2.

Отвисли зависающий вебдрайвер ещё раз

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

Усилия по установлению потерянной с вебдрайвером связи
не дали результатов.
По предварительным данным, поток “CDP Connection” перешёл на нерасчётную орбиту и остановился, столкнувшись с зашаренным локом.
Стактрейсы зависших потоков не поддаются визуальному опознанию.

Что делать - пришлось пока откатить CDP-based authentication до лучших времён, пока не исправится соответствующая бага в вебдрайвере.

Как повторить проблему

Если интересно, как проявляется проблема - запустите этот тест:

  public class BasicAuthTest {
    @RepeatedTest(2)
    void вот_этот_кусок_зависает_на_второй_попытке() {
      open("https://the-internet.herokuapp.com/basic_auth", BASIC, 
           new BasicAuthCredentials("the-internet.herokuapp.com", "admin", "admin"));

      $("#content").shouldHave(text("Congratulations!"));
    }
  }

Первый прогон срабатывает, второй - зависает. На Selenide 6.17.1.

А на Selenide 6.17.2 больше не зависает. Ура.

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

ru.selenide.org

Вышла Selenide 6.17.1

2023-08-20T00:00:00+00:00

Доброе утро!

Сегодня 20 августа - День Восстановления Независимости Эстонии.

В честь этого праздника - небольшой релиз Selenide 6.17.1!

Отвисли зависающий вебдрайвер
Добавили поддержку $.type() в мобилках
Исправили метод $.type(Keys.*)
Убрали пробелы с концов в $$.texts()

Отвисли зависающий вебдрайвер

В релизе Selenide 6.16.0 (на самом деле PR 2358), в селениде случайно появилась бага, из-за которой вебдрайвер мог легко зависнуть. А именно, если вызвать два раза подряд open(url, pageClass), то вебдрайвер накрепко зависает.

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

Вот такие ничоси. :)

  @Test
  public void вот_этот_кусок_зависает() {
    Selenide.open("https://www.google.com/", GooglePage.class);
    Selenide.open("https://www.google.com/", GooglePage.class);
  }

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

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

См. issue 2424 и PR 2428.

Огромное спасибо extryd за чёткое описание проблемы с ультрапростыми инструкциями, как её стабильно повторить. Такое описание бага - неоценимая помощь мейнтейнерам. Все бы тикеты такие были!

Добавили поддержку `$.type()` в мобилках

В предыдущем релизе появился метод

  $.type("Биомеханоиды и трансгендеры");

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

Но оказалось, что он не работал в мобилках (selenide-appium). Теперь будет работать.

См. issue и PR 2408.

Исправили метод `$.type(Keys.*)`

Вышеупомянутый метод type принимает не только строки, но и CharSequence. Что означает, что такой вариант тоже должен работать:

  import org.openqa.selenium.Keys;

  $("input").type(Keys.ENTER);

Вот только он ломался, потому что пытался закастить Keys.ENTER (который вообще-то CharSequence) к типу String. В общем, теперь этот вариант тоже будет работать (хотя польза от него неясна).

Спасибо Oleg Berezhnoy за наблюдательность и issue 2422.
Фикс в PR 2421.

Убрали пробелы с концов в `$$.texts()`

В Selenide 6.16.0 мы ускорили работу с коллекциями с помощью вставок JavaScript кода.
Но вечновнимательный Oleg Berezhnoy заметил, что при этом мы случайно поменяли поведение метода $$.texts(). Раньше он возвращал список текстов элементов, в которых пробелы в начале и конце обрезаны:

  assertThat($$(".burnees").texts()).isEqualTo(List.of(
    "Сиг",
    "Оленегорский горняк",
    "Авиабаза Сольцы",
    "Чонгарский мост",
    "Гениченский мост"
  ));

А с 6.16.0 стал возвращать тексты элементов вместе с пробелами:

  assertThat($$(".burnees").texts()).isEqualTo(List.of(
    "  Сиг   ",
    "    Оленегорский горняк   ",
    "       Авиабаза Сольцы      ",
    "          Чонгарский мост       ",
    "              Гениченский мост       "
  ));

Возможно, это спорный вопрос, как правильно, но во всяком случае так работает стандартный метод WebElement.getText(). Спорить не стали. Теперь $$.texts() снова обрезает пробелы в голове и хвосте.

См. issue 2419 и PR 2427.

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

ru.selenide.org

Вышла Selenide 6.17.0

2023-08-02T00:00:00+00:00

Привіт!

Погнали оновлюватись на Selenide 6.17.0!

Обновились на Selenium 4.11.0
Заменили WebDriverManager на SeleniumManager
Вернули поддержку Java 8
Добавили метод $.type()
Новый метод для мобилок: клик с долгим нажатием
Новый метод для мобилок: свайп влево и вправо
Статистика

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

Мы обновили версию Selenium с 4.10.0 на 4.11.0.

Полный список изменений в Selenium тут.

См. PR 2393.

Заменили WebDriverManager на SeleniumManager

Начиная с версии 4.6.0, в Селениуме появился встроенный механизм для скачивания вебдрайверов - SeleniumManager. Насколько я понимаю, делает его всё тот же Boni Garcia, который создал и WebDriverManager. Только теперь он это делает официально как часть проекта Selenium.

Подробнее про SeleniumManager тут.

И теперь Selenide использует SeleniumManager вместо WebDriverManager.

Да, при этом нам пришлось удалить настройку Configuration.driverManagerEnabled и метод DriverFactory.setupWebdriverBinary. Возможно, у вас сломается компиляция.
Да, немножко фигово, что мы сделали это неожиданно. Обычно мы не удаляем функционал сразу, а сначала помечаем его как @Deprecated и удаляем лишь в следующем мажорном релизе.

Но у нас не осталось выбора.

Давайте я покажу,
откуда на WebDriverManager готовилось нападение?

Начиная с версии 5.4.0, WDM начал требовать Java11+ и перестал работать с Chrome 115. А SeleniumManager и на Java 8 работает, и Chrome 115 поддерживает. И работает из коробки. Что нам ещё оставалось?

См. issue 2402 и PR 2400.

P.S. Если вы всё-таки очень хотите использовать WebDriverManager, не проблема: просто добавьте его в свои зависимости и вызывайте явно в начале тестов:

  WebDriverManager.chromedriver().setup();
  WebDriverManager.firefoxdriver().setup();
  WebDriverManager.edgedriver().setup();
  etc.

Вернули поддержку Java 8

В предыдущем релизе Selenide случайно стал требовать как минимум Java 11. Случилось это как раз из-за обновления WebDriverManager, который внезапно стал требовать Java 11.

А теперь: нет WebDriverManager - нет проблемы. :)

Олды, можете снова запускать свои тесты на Java 8.

Тем не менее очень советую обновляться на Java 11 (а ещё лучше - на Java 17), потому что осенью Selenium перейдёт на Java 11. И тогда у вас точно не останется выбора.

См. issue 2385 и PR 2400.

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

Эту фичу очень давно просили. И вот наконец!

$.type() - это то же, что $.sendKeys(), но с задержками. Типа эмуляция того, как реальный пользователь вводит текст.
Может быть полезно, чтобы сработали автоматические подсказки, автозамена или ещё что-нибудь подобное.

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

$("#query").type("Who the fuck is yevgeny prigozhin");
$("#query").type(text("Who the fuck is dmitry utkin"));
$("#query").type(text("Who the fuck is lvova-belova").withDelay(ofMillis(100)));

По умолчанию задержка между “нажатиями клавиш” - 200 миллисекунд.

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

Новый метод для мобилок: клик с долгим нажатием

Теперь можно делать так:

import static com.codeborne.selenide.appium.SelenideAppium.$;
import static com.codeborne.selenide.appium.AppiumClickOptions.*;

$.click(longPress()); // by default 3 seconds
$.click(longPressFor(Duration.ofSeconds(4)));

См. issue 2370. Спасибо Amuthan Sakthivel за PR 2381.

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

А ещё теперь можно делать так:

import static com.codeborne.selenide.appium.SelenideAppium.$;
import static com.codeborne.selenide.appium.AppiumSwipeOptions.*;

$.swipeTo(); // by default swipes to the right
$.swipe(right());
$.swipe(right(20));
$.swipe(left());
$.swipe(left(30));

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

В общем, обновляйтесь, пробуйте, делитесь:

как вам SeleniumManager?
Всё вообще сломалось, или можно жить?

Статистика

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

(Предыдущий рекорд был в марте: 602 тыщи)

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

ru.selenide.org

Вышла Selenide 6.16.1

2023-07-24T00:00:00+00:00

Привет, пипл!

Мы выпустили небольшое обновление Selenide 6.16.1.

Добавили условия allOf и anyOf
Добавили проверки для cookies
Обновили WebDriverManager
Исправили проверку текстов <tspan> в SVG

Добавили условия `allOf` и `anyOf`

Теперь можно проверить одно из нескольких условий (OR):

$("#president").shouldHave(anyOf(text("Ничтожество"), text("Трусливый бездарь")));

(на самом деле для этого и раньше был метод Condition.or, но anyOf как будто чуть удобнее).

Также можно проверить совпадение всех условий сразу (AND):

$("#generals").shouldHave(allOf(text("бездарней"), text("ничтожней")));

(на самом деле это то же самое, что и $("#generals").shouldHave(text("бездарней"), text("ничтожней")), но зато результат allOf можно вынести в переменную или метод, создав таким образом своё условие).

Спасибо Evgenii Plugatar за PR 2368.

Добавили проверки для cookies

Теперь можно проверять кукисы в браузере:

import static com.codeborne.selenide.Selenide.webdriver;

webdriver().shouldHave(cookie("session_id"));
webdriver().shouldHave(cookie("session_id", "1234567890"));
webdriver().shouldHave(cookie("session_id", "1234567890", Duration.ofSeconds(10)));

С ожиданием результата, кастомным таймаутом и скриншотами при падении - всё, как вы любите.

Спасибо adorne за PR 2367.

Обновили WebDriverManager с 5.4.0 до 5.4.1

Среди прочего, там добавлена поддержка Chrome 115, с которым у многих возникли проблемы.

См. PR 2374.

P.S. На маках Chrome 115 в данный момент не работает. Выскакивает такая ошибка:

SessionNotCreatedException: Could not start a new session.  
  Response code 500.  
    Message: unknown error: cannot find Chrome binary 

Но мы не виноваты, это бага в chromedriver. Обещали скоро исправить.

Исправили проверку текстов `<tspan>` в SVG

Вы когда-нибудь проверяли тексты внутри SVG? Я тоже нет. А они там, оказывается, есть!

  <svg>
    <text x="10" y="30" class="small">
      Люди хотят <tspan>благодарности</tspan>.
    </text>
  
    <text x="10" y="60" class="small">
      Мы не склад <tspan>Amazon</tspan>.
    </text>
  
    <text x="10" y="90" class="small">
      Спасибо тебе, <tspan>Бен Уоллес</tspan>!
    </text>
  </svg>

И теперь их снова можно проверять:

  $$("svg tspan").shouldHave(texts("благодарности", "Amazon", "Бен Уоллес"));

См. issue 2377 и PR 2379.

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

ru.selenide.org

Вышла Selenide 6.16.0

2023-07-02T00:00:00+00:00

Доброй ночи!

У меня к вам предложение, от которого лучше не отказываться.

Обновляйтесь на Selenide 6.16.0!

Ускорили проверки коллекций
Улучшили сообщение об ошибках в коллекциях
Новые проверки для дат date(...) и datetime(...)
Новые методы для установки времени
Полный стектрейс в софт ассертах
BasicAuth в браузерах Chromium
Несколько доменов в BasicAuth
Исправили $.doubleClick() в Appium
Снимаем скриншот чуть раньше
Обновили зависимости
Новости

Ускорили проверки коллекций

Вот это крутизна!

Как вы знаете, одна из базовых возможностей в Селениде - это проверки коллекций. Одной строчкой можно проверить сразу кучу элементов:

$$("option").shouldHave(texts("Шмякино", "Шебекино", "Шелебякино", "Шлёпкино"))

Однако такая проверка занимает время, если коллекция достаточно большая.

Например, если на странице 1000 элементов <option>, на моём компе она занимает почти 3 секунды.
Медленность обусловлена тем, что Селенид спрашивает у браузера текст каждого элемента по отдельности. 1000 вызовов вебдрайвера, даже очень быстрых - это долго.

Пришло время ускорить эти проверки.

Теперь Селенид запрашивает тексты всех 1000 элементов за один вызов вебдрайвера с помощью JavaScript.

Теперь та проверка вместо 3 секунд занимает 200 мс.
В 15 раз быстрее.
Ну очуметь же!

P.S. Для Appium и других возможных вебдрайверов, которые не поддерживают JS, остаётся старый вариант (который запрашивает тексты по одному). Что поделать. Хотя бы не стало хуже.

См. PR 2362.

Улучшили сообщение об ошибках в коллекциях

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

Например, вот такая проверка:

$$(".direction").shouldHave(texts(
  "На Ростов", "На Москву", "В полевые лагеря согласно плану"));

Раньше выдавала просто "Texts mismatch":

Texts mismatch
Actual: [На Ростов, На Москву, В Беларусь]
Expected: [На Ростов, На Москву, В полевые лагеря согласно плану]

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

Text #2 mismatch (expected: "В полевые лагеря согласно плану", actual: "В Беларусь")

См. PR 2362.

Новые проверки для дат `date(...)` и `datetime(...)`

import static com.codeborne.selenide.conditions.datetime.DateConditionOptions.*;

LocalDate theDay = LocalDate.of(2023, 6, 23);
$("#funParty").shouldHave(date(theDay));
$("#funParty").shouldHave(date(theDay, "yyyy-MM-dd"));
$("#funParty").shouldHave(dateBetween(parse("2023-06-22"), parse("2023-06-24")));
$("#funParty").shouldHave(dateFormat("yyyy-MM-dd"));

См. issue 2268. Спасибо Maksim @Au6ojlut за PR 2281.

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

В селениде уже был метод для установки даты (withDate):

LocalDate theDay = LocalDate.of(2023, 6, 23);
$("#euphoriaDay").setValue(withDate(theDay));
// для <input type="date">

Теперь же мы добавили похожие методы для установки даты с временем (withDateTime):

$("#epicFail").setValue(withDateTime(LocalDateTime.parse("2023-06-23 20:29")));
// для <input type="datetime-local">

либо только времени (withTime):

$("#rostov").setValue(withTime(LocalTime.parse("07:00")));
$("#voronezh").setValue(withTime(LocalTime.parse("14:00")));
$("#lipetsk").setValue(withTime(LocalTime.parse("16:00")));
$("#moskva-reka").setValue(withTime(LocalTime.parse("20:20")));
// для <input type="time">

См. PR 2357.

Полный стектрейс в софт ассертах

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

Вопрос в том, что для этих ошибок Селенид показывал неполный стектрейс, и там не была видна часть “Caused by:”. Теперь будет видна. Будьте готовы к тому, что длина стектрейсов резко вырастет :).

См. issue 2350 и PR 2354.

Улучшили BasicAuth в браузерах семейства Chromium

В Селениде есть методы для авторизации на странице через BasicAuth:

open("/basic-auth/hello", "", "admin", "Казкова діброва");

До сих пор было две реализации BasicAuth.

При включённом прокси: Селенид добавляет к запросу заголовок Authorization (Basic YWRtaW460JrQsNC30LrQvtCy0LAg0LTRltCx0YDQvtCy0LA=).
При выключенном прокси: Селенид добавляет логин и пароль в URL (https://admin:Казкова+діброва@localhost:42220/basic-auth/hello).

Теперь к ним добавился третий вариант: Если вебдрайвер реализует интерфейс org.openqa.selenium.HasAuthentication, Селенид добавляет логин+пароль через него. Фактически это означает браузеры семейства Chromium (Chrome, Chromium, Edge).

См. issue 2336 и PR 2358.

Несколько доменов в BasicAuth

До сих пор можно было прописать только один домен для BasicAuth:

open("/basic-auth/hello", "mister-cider.ru", "luka", "картофельный спас");

Это не помогает, если в тестируемом приложении задействовано несколько доменов - например, оно открывает фреймы с адресом auth.mister-cider.ru или там api.mister-cider.ru. Всегда можно прописать пустую строку вместо домена, но у этого варианта есть очевидные минусы.

Теперь можно прописать несколько доменов через запятую или “|”:

open("/basic-auth/hello", "mister-cider.ru|auth.mister-cider.ru|api.mister-cider.ru", 
          "luka", "картофельный спас");

См. PR 2358.

P.S. Естественно, имя домена не используется, когда Селенид добавляет логин+пароль просто в URL.

Исправили `$.doubleClick()` в Appium

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

$(AppiumBy.xpath(".//android.widget.CheckBox")).doubleClick();

См. issue 2346 и PR 2347.

Снимаем скриншот чуть раньше

Обычно Селенид автоматически делает скриншот в случае падения теста. НО Если вы закрывали браузер в методе @AfterEach, то Селенид уже не мог сделать скриншот:

@AfterEach
void tearDown() {
  Selenide.closeWebDriver();
}

Теперь Селенид будет делать скриншот чуть раньше - ДО методов @AfterEach.

См. issue 2352 и PR 2356.

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

2319 use latest version of geckodriver for FF 102+
2328 bump Selenium from 4.9.1 to 4.10.0
2324 Bump io.appium:java-client from 8.5.0 to 8.5.1
2349 Bump Netty from 4.1.93.Final to 4.1.94.Final
bump WebDriverManager from 5.3.3 to 5.4.0

Новости

Пост Page Object – простой пример с использованием Selenide на IT-notes
Видос Run Selenide Appium Test in LambdaTest в блоге “Testing Mini Bytes”

Ну что, нормальный результат, я считаю.
ВСЕХ ВЗБОДРИЛИ!!!
Счастливо!

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

ru.selenide.org

Вышла Selenide 6.15.0

2023-05-29T00:00:00+00:00

Доброй ночи!

Есть люди, которые постоянно деплоят, а есть люди, которые один раз в жизни где-то выучили, что должен быть РЕЛИЗ — и копят, копят, копят фичи для этого релиза.
А счастливый дедушка-мейнтейнер думает, что ему хорошо.
И как использовать опенсорс-проект, если вдруг случайно окажется, что этот дедушка — законченный мудак?

Как вы поняли, мы выпустили новую версию Selenide 6.15.0 с серьёзными такими внутренними переделками.

Влили проект selenide-selenoid в selenide
Влили проект selenide-appium в selenide
Клик теперь проверяет, что элемент не disabled
Маскируем переводы строк в отчёте
Комбинированные селекторы для мобилок
Новые проверки для мобилок
Новые селекторы для мобилок
Переключение контекста в мобилках
Переколбас CollectionCondition
Новости

Влили проект `selenide-selenoid` в `selenide`

Это позволит нам легче менять и релизить эти проекты. Для вас поменяется объявление зависимости. Вместо

  testImplementation("org.selenide:selenide-selenoid:2.3.7")

Теперь нужно будет прописать:

  testImplementation("com.codeborne:selenide-selenoid:6.15.0")

См. PR 2292.

Влили проект `selenide-appium` в `selenide`

Это позволит нам легче менять и релизить эти проекты. Вам всего лишь нужно будет обновить версию selenide-appium с 2.8.1 на 6.15.0

См. PR 2291.

Клик теперь проверяет, что элемент не disabled

Как вы знаете, метод $.click() требует, чтобы элемент был видимым (более точно: либо элемент должен быть видимый, либо иметь css свойство opacity: 0).

НО до сих пор Селенид не проверял, что элемент enabled. Другими словами,

Селенид разрешал кликать на disabled элементы.

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

В общем, теперь аргумент №2 победил. Теперь метод $.click() дождётся, пока элемент станет enabled. А если не станет - клик упадёт.

Теперь вы можете смело сократить все свои тесты:

$.shouldBe(enabled).click() заменить на $.click().

P.S. Если вы из лагеря аргумента №1, то можете вместо клика использовать $.shouldBe(disabled).

См. issue 2288. Спасибо Maksim @Au6ojlut за PR 2290.

Маскируем переводы строк в отчёте

Если вы пробовали использовать в тесте многострочную строку:

$.shouldHave(text("Если\n дедушка\n законченный\n мудак");

То могли заметить, что в отчёте эта строка выглядела коряво и ломала всю таблицу.

А теперь будет красиво.

См. issue 2283. Спасибо Maksim @Au6ojlut за PR 2284.

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

При тестировании мобильных приложений удобно задать в одной проверке два селектора: отдельно для Android и iOS.
Раньше приходилось придумывать вспомогательные методы или городить ифы.

Теперь же можно объявить “комбинированный” селектор с помощью CombinedBy:

import static com.codeborne.selenide.appium.selector.CombinedBy.android;
import static com.codeborne.selenide.appium.AppiumSelectors.byTagAndName;

$(android(byText("Бибер")).ios(byText("Долик")))
  .shouldHave(text("Бибер"));

Новые проверки для мобилок

Аналогичное решение для проверок: теперь можно одной строкой задать “комбинированную” проверку и для Android, и для iOS с помощью класса CombinedAttribute:

import static com.codeborne.selenide.appium.conditions.CombinedAttribute.android;
import static com.codeborne.selenide.appium.AppiumCondition.attribute;
import static io.appium.java_client.AppiumBy.accessibilityId;

// Проверка элемента:
$.shouldHave(attribute(
  android("content-desc").ios("name"), 
  "Гойду, Жерасимов, где, сука, ебоприпасы?"
));

// Проверка коллекции:
$$.shouldHave(attributes(android("text"), 
  "Бздила картонный", 
  "Болтун безмозглый", 
  "Вазелиновая коррекция",
  "Зять-«у*бок»",
  "Сын-отморозок"
));

Новые селекторы для мобилок

Для кучи, нас появилась пачка новых селекторов для поиска элементов по тэгу, тексту, подстроке и т.п.:

import static com.codeborne.selenide.appium.AppiumSelectors.*;

$(byAttribute("content-desc", "Hello")).click();
$(byContentDescription("Hello")).click();
$(byTagAndAtttribute("android.widget.TextView", "Не")).click();
$(byTagAndName("XCUIElementTypeStaticText", "вы е")).click();
$(withTagAndName("XCUIElementTypeText", "бываться на красной площади")).click();

См. issue 2300. Спасибо Amuthan Sakthivel за PR 135. Также см. PR 2315.

Переключение контекста в мобилках

Зачастую мобильные приложения открывают какой-то контент во встроенном браузере (WebView). А то и полностью построены на WebView. При тестировании таких приложений требуется переключаться между “нативным” и “веб” контекстом.

Теперь для переключения есть удобные методы:

// Тут мы в "нативном" контексте
open();
$(accessibilityId("URL input field")).setValue("www.google.com");
$(accessibilityId("Go To Site button")).click();

// Опа, и мы уже в "веб" контексте:
switchTo().context("WEBVIEW_com.saucelabs.mydemoapp.rn");
$("#i-am-not-a-robot").click();

assertThat(getContextHandles()).hasSize(2)

См. PR 2308.
Спасибо Amuthan Sakthivel за PR 149.

Переколбас CollectionCondition

Мы поменяли внутреннее устройство условий для коллекций (класс CollectionCondition).

Раньше, если вы хотели создать кастомную проверку для коллекций, вы должны были реализовать метод test(elements):

var allTextsStartingWithZ = new CollectionCondition() {
  public boolean test(List<WebElement> webElements) {
    return webElements.stream()
      .map(webElement -> webElement.getText().startsWith("Z"))
      .reduce(true, (x, y) -> x && y);
  }
}
$$(".mudak").shouldHave(allTextsStartingWithZ)

Этот метод останется ещё на какое-то время (для сохранения обратной совместимости), но рекомендуемый метод теперь будет check(CollectionSource collection):

var allTextsStartingWithZ = new CollectionCondition() {
  public CheckResult check(CollectionSource collection) {
    List<WebElement> elements = collection.getElements();
    List<String> actualTexts = ElementsCollection.texts(elements);

    boolean allMatched = webElements.stream()
      .map(webElement -> webElement.getText().startsWith("Z"))
      .reduce(true, (x, y) -> x && y);
    return new CheckResult(allMatched, actualTexts);
  }
}
$$(".mudak").shouldHave(allTextsStartingWithZ)

Что нам это даёт?

В будущем это откроет нам возможности для улучшений проверок коллекций:

Можно будет сильно ускорить проверки: например, быстро получить тексты всех элементов коллекции за один вызов JavaScript кода.
В сообщении об ошибке писать не “актуальные тексты на момент составления сообщения”, а “актуальные тексты на момент последней проверки”. Как в этой проблеме, только с коллекциями.

См. PR 2312 и PR 2307.

Новости

Исторический момент: первый мем про селенид
Моё выступление на новогоднем девклубе: Думай как пиарщик
Видос Тестируем Spring с помощью Selenide от kanezi
Серия видосов на Testing Mini Bytes: Selenide + Allure = Beautiful HTML Reports
Пост Why we chose Selenide over Selenium от Amuthan Sakthivel

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

ru.selenide.org

Вышла Selenide 6.14.0

2023-05-08T00:00:00+00:00

Привет!

Пока не начался контрнаступ, давайте-ка обновимся на Selenide 6.14.0 - а то потом будет не до него.

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

Ускорили дебаг
Убрали флажок --no-sandbox
Добавили метод step для отчётиков
Добавили метод $.dragAndDrop(DragAndDropOptions)
Браузер за экран
Обновили зависимости
Новости
Статистика

Ускорили дебаг

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

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

Теперь этот процесс должен сильно ускориться. Селенид больше не будет обращаться к вебдрайверу, а просто покажет локатор элемента:

Но и формат метода $.toString() / $$.toString() тоже изменился. Будьте готовы.

См. issue 2253. и PR 2269.

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

Убрали флажок хрома `--no-sandbox`

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

Но

Некоторые пользователи говорят, что без флажка --no-sandbox хром не запускается в докере
А другие пользователи говорят, что с флажком --no-sandbox процесс хрома остаётся висеть в фоне и пожирает весь CPU. Но это вроде только на винде (?)

В общем, мы убрали этот флажок, потому что пользователям №1

легко обнаружить проблему (хром тупо не запускается)

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

Configuration.browserCapabilities = 
  new ChromeOptions().addArguments("--no-sandbox");

См. issue 2270 и PR 2271.

Добавили метод `step` для отчётиков

Если вы используете селенидовский встроенный отчёт (TextReport), то теперь можете группировать действия в “шаги” с помощью нового метода step:

@Test
void authentication() {
  step("login",()->{
    open("/login.asp");
    $("#username").val("u");
    $("#password").val("p");
  });

  step("logout",()->{
    $("#logout").click();
    $("#goodBye").shouldHave(text("Good bye looser!"));
  });
}

В отчёте шаги будут визуально выделяться.

+---------------+-----------------------------------------------+-------+------+
| Element       |Subject                                        |Status | ms.  |
+---------------+-----------------------------------------------+-------+------+
| login         |                                               |PASS   | 4000 |
|    open       | http://127.0.0.1:8080/my_account/account.html |PASS   | 2662 |
|    #username  | val "u"                                       |PASS   | 300  |
|    #password  | val "p"                                       |PASS   | 400  |
| logout        |                                               |PASS   | 1023 |
|    #logout    | click                                         |PASS   | 923  |
|    #goodBye   | should have text "Good bye looser!"           |PASS   | 100  |
+---------------+-----------------------------------------------+-------+------+

Кстати, шаги могут быть вложенными друг в друга.

См. issue 2172. Спасибо Maksim @Au6ojlut за PR 2250.

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

Теперь метод $.dragAndDrop приобрёл более логичное звучание: сначала “что”, потом “куда” и наконец, “как”.

$("#drag1").dragAndDrop(to("#div2"));
$("#drag1").dragAndDrop(to("#div2").usingJS());

Спасибо Maksim @Au6ojlut за PR 2245.

Разрешили двигать браузер за экран

Исправили мелкую багу, из-за которой нельзя было проставить негативные значения в позиции браузера:

Configuration.browserPosition = "-1900x-450";

Слабо себе представляю, зачем это может быть полезно, но исправили.

См. issue 2258 и PR 2259.

Путь к бинарнику Edge

В селениде есть настройка Configuration.browserBinary, позволяющая задать путь к бинарнику браузера. (на всякий случай: в большинстве случаев её не нужно задавать).

Раньше эта настройка не поддерживалась для браузера Edge, а теперь поддерживается. Ура.

Спасибо Vladislav Velichko за PR 2267.

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

Selenium 4.9.1 - см. ченджлог
Netty 4.1.92.Final

Новости

Серия уроков Selenide Java with Cucumber от TechPro Education
Обзор Jetbrains Aqua для автоматизации тестирования от Oleh Pendrak

Статистика

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

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

ru.selenide.org

Вышла Selenide 6.13.0

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

Привет!

Сегодня у нас большой мажорный релиз Selenide 6.13.0.

Добавили метод $.cached()
Добавили http статус при моке ответа сервера
Новый метод inNewBrowser для запуска куска кода в новом браузере
Добавили метод $.doubleClick(options)
Добавили условие $.shouldHave(innerText())
Добавили условие для коллекций $$.shouldHave(attributes(...))
Ясное сообщение об ошибки в методах $.select*()
Исправили ошибку в методе $$.subList()
Обновили зависимости
Новости

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

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

ElementsCollection subscriptions = $$("div.subs-expands")
  .filter(childExactText(
     By.xpath(".//div[contains(@class,'data')]//div[contains(@class,'heading')]"),
     orderNumber)
  );

SelenideElement target = subscriptions
  .filter(childAttributeValue(...))
  .find(childExactText(....));

Каждое обращение к target заметно притормаживает.

Теперь такие тесты можно ускорить, закэшировав значение target:

SelenideElement target = subscriptions
  .filter(..)
  .find(..)
  .cached();

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

См. issue 2171, issue 1927 и PR 2189.

Добавили http статус при моке ответа сервера

В селениде есть методы, чтобы замокать ответ сервера:

getSelenideProxy().responseMocker().mockText("login-mock", 
          urlContains(POST, "/login"), () -> "{role: admin}");

Раньше можно было мокать только тело ответа, но статус всегда оставался 200 (“OK”).
Теперь можно задать и другой статус:

getSelenideProxy().responseMocker().mockText("login-mock", 
          urlContains(POST, "/login"), 403, () -> "{role: looser}");

См. issue 2227 и PR 2234.

Новый метод `inNewBrowser` для запуска куска кода в новом браузере

Иногда вам хочется посреди теста запустить кусок кода в новом браузере.

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

Уже давно для этого есть метод using. Но он требует, чтобы вы открыли новый браузер с какими-то своими настройками. А что, если вам подходят обычные селенидовские настройки? То есть вам нужен точно такой же браузер, только новый?

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

open("https://site.com/login/as/user/bob");

inNewBrowser(() -> {
  open("https://site.com/login/as/admin");
  $(by("value", "bob")).find("[name=is_admin]").setEnabled();
});

$("h1").shouldHave(text("Hello, chat admin!"));

См. issue 2213 и PR 2236.

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

Раньше был просто метод $.doubleClick(), который мог кликать только по центру элемента. Теперь же у него появился продвинутый тёзка с параметром options. Опции такие же, как и у обычного клика:

$(".btn").doubleClick(usingDefaultMethod());
$(".btn").doubleClick(usingJavaScript());
$(".btn").doubleClick(usingDefaultMethod().offset(66, 33));
$(".btn").doubleClick(usingJavaScript().offset(66, 33).withTimeout(ofSeconds(9)));

См. issue 2133. Спасибо aakachurin за PR 2135.

Добавили условие `$.shouldHave(innerText())`

Оно позволит проверять текст невидимых элементов.

Скорее всего это плохая идея: раз пользователь не видит элемента, значит, и проверять его не надо.

Но если всё-таки очень хочется, то можно:

$("#theHiddenElement")
  .shouldHave(innerText("Видишь суслика? И я не вижу. А он есть!"));
  // Обычный $("#theHiddenElement").text() выдаёт здесь пустую строку "";

См. issue 2220 и PR 2223.

Добавили условие для коллекций `$$.shouldHave(attributes(...))`

$$("#numbers option").shouldHave(attributes("value", 
                  "one", "two", "three", "four", "five"));

См. issue 2091. Спасибо Alexey Lakovych за PR 2091. Также см. PR 2230.

Ясное сообщение об ошибки в методах `$.select*()`

В селениде есть методы для работы с выпадающими списками:

$("select#gender").selectOptionContainingText("Female");

Недавно мы переделали их реализацию на JavaScript - так быстрее и надёжнее.

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

$("ul").selectOptionContainingText("Kelly Snyder");
--> JavascriptException: 
      javascript error: 
        undefined is not iterable (cannot read property Symbol(Symbol.iterator))

Теперь сообщение будет понятное:

IllegalArgumentException: Cannot select option from a non-select element

См. issue 2231 и PR 2233.

Исправили ошибку в методе `$$.subList()`

Как вы знаете, в селениде есть удобные методы для проверки разом целой коллекции элементов:

  $$("#numbers").shouldHave(texts("One", "Two", "Three", "Four", "Five"));

Но метод $$ возвращает объект ElementsCollection, который, к сожалению, наследуется от AbstractList<SelenideElement>. А потому случайно (так не задумывалось!) наследует от него некоторые методы, на которые мы не рассчитывали.

Один из таких методов - subList:

  $$(".user").subList(1, 4).iterator();

Приведённый выше итератор возвращает не три, а всего два элемента. Обрезает последний. Ошибочка. ¯\_(ツ)_/¯

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

См. issue 2239 и PR 2240.

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

bump Selenium from 4.8.1 to 4.8.3 – см. CHANGELOG
bump LittleProxy from 2.0.16 to 2.0.17
bump BrowserUpProxy from 2.2.8 to 2.2.9
bump nettyVersion from 4.1.90.Final to 4.1.91.Final

Новости

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

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

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

ru.selenide.org

Вышла 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
Добавили поддержку OpenTest4j
Показываем стектрейс под каждой ошибкой в SoftAsserts
Добавили метод $.shadowRoot()
Добавили метод $.ancestor()
Обогатили методы $.closest() и $.ancestor()
Починили метод $.screenshot() на маках
При падении текстовых проверок селенид выдаёт точное значение на момент падения
Запретили пустой аргумент в методе $.matchText("")
Добавили проверку webdriver().shouldHave(title(...))
selenide-selenoid 1.2.0
selenide-appium 1.7.0
Ссылки
Статистика использования Селенида
Юбилей Selenide

Поддержка 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 тысяч скачиваний в месяц.

Юбилей Selenide

Кстати, мы вплотную подошли к ещё одному знаковому рубежу: в октябре Селениду исполняется… 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

Вышла Selenide 7.6.0

Добавили видео рекордер

Добавили because для условий вебдрайвера

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

Поддержка специальных пробелов

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

Исправили аппиумскую пэдж фактори

Уменьшили количество селенидовских логов

Подправили поведение Selenide.screenshot(filename)

JSR305 -> JSpecify

Упростили кастомные команды

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

Новости

Статистика

Вышла Selenide 7.5.0

Можно открывать браузер с новой конфигурацией

Починили события в селектах

Укоротили API для скачивания файлов

Больше не закрываем окна при скачивании файлов

Больше не ловим вообще все ошибки

Починили кастомные обработчики ошибок

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

Новости

Статистика

Вышла Selenide 7.3.1

Мокать ответ сервера заданного типа

Исправили метод $.clear() в мобилках

Исправили сообщение при клике на некорректную ссылку

Отключили предупреждение Хрома про сворованные пароли

Исправили загрузку файлов через CDP для кастомных вебдрайверов

Задеприкейтили настройку holdBrowserOpen

Обновили Selenium с 4.19.1 до 4.20.0

Статистика

Вышла Selenide 7.2.0

Скачиваем файлы из Selenium Grid

Скачиваем файлы удалённо с помощью CDP

Коллекции элементов для мобилок

Выключили предупреждение хрома про покраденные пароли

Сообщение об ошибке, если нет href

Обновили Selenium с 4.17.0 на 4.18.1

Вышла Selenide 7.1.0

Скачивание файлов с помощью CDP

Условие animated для окончания анимации

Добавили IF с таймаутом ¯¯_(ツ)_/¯¯

Можно кликать задизейбленные элементы

Метод $.unfocus()

Исправили page load timeout в мобилках

Можно добавлять прокси фильтр многократно

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

Статистика

Вышла Selenide 7.0.1

Вернули циклы по коллекциям

Вернули метод isEmpty() у коллекций

Вернули поле self в контейнерах

Переименовали CollectionCondition в WebElementsCondition

UPD 7.0.2: Обновились на Selenium 4.15.0

Вышла Selenide 7.0.0

Обновились на Java 17

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

Исправили дедлок при инициализации классов

Актуальное значение на момент проверки

Удалили старые методы в Condition

Удалили старые методы в CollectionCondition

Удалили старые методы в ElementsCollection

Заменили ElementsContainer на Container

Заменили FileNotFoundException на FileNotDownloadedError

Переименовали некоторые *Exception классы в *Error

Удалили поддержку устаревшего WebDriverEventListener

Удалили старые методы для Drag’n’drop

Удалили устаревшие методы $.getSelectedValue() и $.getSelectedText()

Удалили старые аннотации для TestNG @Report и @GlobalTextReport

Остальное

Вышла Selenide 6.19.1

Вышла Selenide 6.19.0

Новый метод $.highlight() для подсветки элемента

Зачем это надо?

Как именно он подсвечивается?

Дальнейшее развитие

Убираем невидимые пробелы в текстах коллекций

Добавили `because` для условий вебдрайвера

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

Исправили `inNewBrowser` с кастомной конфигурацией

Подправили поведение `Selenide.screenshot(filename)`

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

Задеприкейтили настройку `holdBrowserOpen`

Сообщение об ошибке, если нет `href`

Условие `animated` для окончания анимации

Метод `$.unfocus()`

Вернули метод `isEmpty()` у коллекций

Вернули поле `self` в контейнерах

Переименовали `CollectionCondition` в `WebElementsCondition`

Удалили старые методы в `Condition`

Удалили старые методы в `CollectionCondition`

Удалили старые методы в `ElementsCollection`

Заменили `ElementsContainer` на `Container`

Заменили `FileNotFoundException` на `FileNotDownloadedError`

Переименовали некоторые `Exception` классы в `Error`

Удалили поддержку устаревшего `WebDriverEventListener`

Удалили устаревшие методы `$.getSelectedValue()` и `$.getSelectedText()`

Удалили старые аннотации для TestNG `@Report` и `@GlobalTextReport`

Новый метод `$.highlight()` для подсветки элемента

Заменили класс `ElementsContainer` на интерфейс `Container`

Добавили методы `$.tap()`, `$.doubleTap()` для мобилок

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

Метод `getFocusedElement()` обленился

Добавили поддержку полей `SelenideAppiumElement` в пэдж обжектах

Нельзя наследовать пэдж обжект от `ElementsContainer`

Добавили поддержку `$.type()` в мобилках

Исправили метод `$.type(Keys.*)`

Убрали пробелы с концов в `$$.texts()`

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

Добавили условия `allOf` и `anyOf`

Исправили проверку текстов `<tspan>` в SVG

Новые проверки для дат `date(...)` и `datetime(...)`

Исправили `$.doubleClick()` в Appium

Влили проект `selenide-selenoid` в `selenide`

Влили проект `selenide-appium` в `selenide`

Убрали флажок хрома `--no-sandbox`

Добавили метод `step` для отчётиков

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