Selenide

Вышла 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 5.15.0

2020-09-26T00:00:00+00:00

Всем привет!

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

Добавили настройку `Configuration.pageLoadTimeout`
(по умолчанию 30 секунд)

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

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

Поэтому мы добавили в Selenide настройку Configuration.pageLoadTimeout, чтобы этот таймаут было легко менять.

Внимание! Значение по умолчанию - 30 секунд. Если ваши тесты начали падать по таймауту - знайте, какую настройку подкрутить.

См. issue 1268 и PR 1269.

Добавили универсальный метод клика
с параметром `ClickOptions`

В некотором роде это новое слово в API селенида.

В селениде изначально был метод $.click(), который просто вызывал обычный селениумовский метод WebElement.click(). Который кликает (вроде как) в центр элемента.

Со временем начали появляться вариации:

Настройка Configuration.clickViaJs, чтобы кликать не вызовом WebElement.click(), а через JavaScript. Теоретически это должно сделать тесты стабильнее (а может, и быстрее) и позволит кликать то, что обычно не получается.
Клик со сдвигом $.click(offsetX, offsetY), чтобы кликать не в центр элемента

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

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

Теперь кликать можно без изменения глобальной настройки, хоть обкликайся:

  $("#page").click(usingJavaScript());
  $("#page").click(usingJavaScript().offset(123, 222));
  $("#page").click(usingJavaScript().offsetY(222));
  $("#page").click(usingDefaultMethod());

NB! Мы рекомендуем выставить настройку Configuration.clickViaJs в то значение, которое вам подходит в большинстве случаев, и задавать параметр ClickOptions точечно - только там, где он необходим.

См. issue 1173.
Спасибо Dmytro Stekanov за PR 1226.

Добавили универсальный метод скачивания файла
с параметром `DownloadOptions`

Аналогичная история была с методом $.download(). Изначально он умел скачивать файлы только одним способом - через GET запрос. Потом селенид научился скачивать файлы через прокси. Недавно мы добавили третий способ - FOLDER.
До сих пор способ скачивания можно было задать только через глобальную настройку Configuration.fileDownload.

А теперь способ скачивания можно задавать через параметр в каждый вызов $.download, не меняя глобальную настройку:

  File f = $("input").download(DownloadOptions.using(PROXY);
  File f = $("input").download(DownloadOptions.using(PROXY).withTimeout(9999));
  File f = $("input").download(DownloadOptions.using(PROXY).withFilter(withExtension("xls")).withTimeout(9999));
  File f = $("input").download(DownloadOptions.using(FOLDER);
  File f = $("input").download(DownloadOptions.using(FOLDER).withTimeout(9999));
  File f = $("input").download(DownloadOptions.using(FOLDER).withFilter(withExtension("pdf")).withTimeout(9999));

NB! Мы рекомендуем выставить настройку Configuration.fileDownload в то значение, которое вам подходит в большинстве случаев, и задавать параметр DownloadsOptions точечно - только там, где он необходим.

См. issue 1259 и PR 1260.

Добавили методы для работы с LocalStorage

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

// Очистить всё содержимое:
localStorage().clear();

// Добавить значение:
localStorage().setItem("username", "john");

// Проверить значение:
assertThat(localStorage().getItem("username")).isEqualTo("john");

// Проверить количество элементов:
assertThat(localStorage().size()).isEqualTo(1);

// удалить значение:
localStorage().removeItem("username");
assertThat(localStorage().getItem("username")).isNull();

Спасибо Dmytro Stekanov за PR 1274.

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

Классическая селенидовская проверка $.shouldHave(text("Hello, world")) включает и текст самого элемента, и тексты всех его потомков.
А иногда хочется проверить только текст самого элемента, без потомков. Для этого мы добавила две новых проверки:

  $.shouldHave(ownText("Hello"));           // Элемент должен содержать текст "Hello"
  $.shouldHave(exactOwnText("Hello"));      // Текст элемента должен быть "Hello" 

См. issue 1261 и PR 1262.

Ускорили работу с большими фильтрованными коллекциями

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

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

ElementsCollection list = $$("li").filter(visible);   // На странице 100 элементов <li>
for (int i = 0; i < 10; i++) {
  list.get(i).shouldBe(visible);
}

Если на странице, предположим, 100 элементов <li>, то такой тест может очень долго работать.

Ведь селенид на каждом шагу должен перегрузить элемент - вдруг его состояние изменилось!
А чтобы перегрузить N-ный элемент коллекции, нужно перегрузить всю коллекцию (в селениуме ведь нет метода WebDriver.findElement(index)).
А чтобы перегрузить фильтрованную коллекцию, нужно пройтись по всем её элементам и применить фильтр для каждого (в данном примере - вызвать WebElement.isDisplayed()).

Для сравнения, такой цикл работает гораздо быстрее:

ElementsCollection unfiltered = $$("li");   // Нефльтрованная коллекция 
for (int i = 0; i < 10; i++) {
  unfiltered.get(i).shouldBe(visible);
}

В этом релизе мы немного ускорили работу с коллекциями. Теперь Селенид фильтрует коллекцию умнее: чтобы получить list.get(N), он применяет фильтр visible не для всех 100 элементов, а только для первых <N> элементов.

См. issue 1266 и PR 1270.

P.S. Напомню, что другой вариант ускорить тесты в таких случаях - использовать метод snapshot:

ElementsCollection list = $$("li").filter(visible).snapshot(); // snapshot() создаёт "слепок" коллекции. Селенид не будет её перегружать каждый раз. 
for (int i = 0; i < 10; i++) {
  list.get(i).shouldBe(visible);
}

Но при использовании snapshot есть риск словить StaleElementReferenceException, если коллекция всё-таки обновилась во время цикла.

Добавили проверку “href”

Иногда хочется в тесте проверить, что у элемента <a> правильное значение атрибута href, т.е. ссылки.
Для этого всегда можно было использовать метод $("a").shouldHave(attribute("href", "/foo/bar/details.html").

Проблема в том, что такая проверка очень неочевидно падает, потому что селениум возвращает абсолютный, а не относительный URL.
Подробнее см. в докладе Алексея Баранцева “Заморочки в Selenium WebDriver” с 57:11.

Чтобы хоть немножко облегчить эту заморочку, мы добавили проверку “should have href” для ссылок:

  `$("a").shouldHave(href("/foo/bar/details.html"))`

См. issue 1272 и PR 1273.

Добавили опцию хрома “–no-sandbox”

Я где-то вычитал, что она сделает тесты на хроме стабильнее. Скрестим пальцы и будем надеяться.

См. commit 3293956d

Селенид теперь явно кидает ошибку

… если не удалось создать папку для скачивания файлов.

См. issue 1265 и commit 94ece98f](https://github.com/selenide/selenide/commit/94ece98f).

Обновились на WebDriverManager 4.2.2

См. WDM Changelog.

Видеообзор

Смотрите видеообзор данного релиза.

Новости

Приходите 4-7 ноября 2020 на онлайн-конференцию Heisenbug!

Я там тоже буду выступать:

Воркшоп “Как начать свой проект автоматизации с нуля (с божьей помощью и Selenide)” - для начинающих
Доклад “Flaky tests. Метод” - для опытных

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

ru.selenide.org

Вышла Selenide 5.14.0

2020-08-17T00:00:00+00:00

Всем привет!

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

Стабилизировали новый способ скачивания файлов `FOLDER`

… который появился в Selenide 5.13.0.

Вот что поменялось в 5.14.0:

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

См. issue 1220 и PR 1221.
- Увы, это не работает для IE и Safari (которые в принципе не позволяют задать папку для скачивания файлов)
- Также это работает только для тех браузеров, которые открывает селенид.
- Если же вы сами открываете браузер и передаёте его селениду, вам нужно будет создать уникальную папку самостоятельно и передать её селениду:
  - Либо с помощью нового метода setWebDriver(driver, proxy, downloadsFolder),
  - либо конструктора SelenideDriver(..., downloadsFolder).
Перед началом каждого скачивания файла селенид очищает папку – см. PR 1252
Селенид удаляет все пустые папки для скачиваний в конце тестов – см. PR 1247

Добавили проверку `$$.shouldHave(itemWithText("any text"))`

В отличие от классической $$.shouldHave(texts("text1", "text2")), она означает, что в коллекции есть хотя бы один элемент с данным текстом.

Спасибо Luis Serna за PR 1194.

Кстати, это первый коммит в селенид аж из Боливии!

Добавили поддержку браузера Safari

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

Как обычно, достаточно просто прописать

Configuration.browser = "safari"; либо
-Dselenide.browser=safari

Делитесь впечатлениями.

См. issue 1236 и PR 1237.

Добавили метод `SelenideDriver.screenshot(fileName)`

Полезно, если вы создаёте “нестатический” вариант драйвера (new SelenideDriver()) и хотите снимать скриншоты.
Теперь можно.

См. issue 1166 и PR 1227.

Добавили метод `SelenideDriver.screenshot(OutputType)`

Иногда хочется получить скриншот в формате Base64. Например, этот формат хотят некоторые инструменты для сравниения скриншотов.

Теперь их можно получить таким вызовом:

String screenshot = Selenide.screenshot(OutputType.BASE64);
byte[] decoded = Base64.getDecoder().decode(screenshot);
BufferedImage img = ImageIO.read(new ByteArrayInputStream(decoded));

См. issue 1224 и PR 1231.

Теперь селенид снимает скриншот в случае падения `switchTo()`

Как вы знаете, Селенид автоматически делает скриншот в случае падения тестов.
Но мы обнаружили, что Селенид НЕ делал скриншот, если упал один из этих методов:

switchTo(frame)
switchTo(window)
switchTo(alert)

Теперь мы исправили эту досадную оплошность.

См. issue 1190 и PR 1240.

Добавили хрому опцию `--disable-dev-shm-usage`

Мы тут вычитали, что без этой опции Chrome может крэшиться из-за out of memory error.

Почему никто из вас на это не жаловался?
Стало ли лучше после добавления это опции?

P.S. Позже люди жаловались и на наличие этой опции. Эпопея пока не окончена.

Исправили работу Sizzle селекторов на страницах с Dojo.js, troop.js и т.п.

См. issue 434 и PR 1242.

Сделали метод `$.toString()` безопаснее

См. issue 1241 и PR 1245.

Улучшили сообщение об ошибке, если элемент внезапно пропал

См. issue 1013 и PR 1239.

Обновились на WebDriverManager 4.1.0

См. WDM Changelog.

Видеообзор

Смотрите видеообзор данного релиза.

Новости

Ничоси! Курс на Udemy “Selenium и Selenide для начинающих Automation QA, QC на Java”
Про селенид на немецком
Пример проекта на Selenide+Selenoid+Docker от d3m0
Ещё пример: сравнение скриншотов с Selenide+Allure+Ashot+Screen Diff Plugin от Evgeniy Asovin
Ещё пример: Selenide + Appium + Allure + TestNG от qaschevychelov
Сравнение Selenide и Selenium 2019 года: Choosing tools for UI testing: Selenium or Selenide? - 17.09.2019
Статья Jakub Skibiński в блоге компании Sonalake: Selenide: A Powerful Testing Framework - 19.06.2020
Статья “Почему мы перешли на Selenide, попутно написав более 200 новых автотестов” - 30.04.2020
Switch from Serenity to Selenide - 22.05.2020 от Yuri Kudryavtsev (Maxilect company)

И целая серия статей от Alexander Pushkarev:

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

ru.selenide.org

Вышла Selenide 5.13.0

2020-07-08T00:00:00+00:00

Всем привет!

Лето не повод расслабляться! Мы выпустили релиз Selenide 5.13.0.

Будьте осторожны, он может сломать ваши тесты (если они были неаккуратно сделаны).

Метод `$.shouldHave(text(""))` кидает ошибку

Возможно, самый популярный метод селенида - это $.shouldHave(text("что-то")). Но даже если вы используете его каждый день, возможно, вы не подозреваете, что он проверяет подстроку. Т.е. проверка $("h1").shouldHave(text("ello")) сработает и для элемента <h1>Hello World</h1>.

Частный случай такой проверки - $("h1").shouldHave(text("")). Такую проверку пройдёт любой элемент, ведь любая строка содержит пустую подстроку. То есть такая проверка просто бессмысленна.

Если вам нужно убедиться, что текст пустой, используйте $("h1").shouldHave(exactText("")) или $("h1").shouldBe(empty).

Мы хотим вам помочь избежать этой типичной проблемы и избавиться от бессмысленных проверок. Для этого теперь селенид будет бросать ошибку, если вы попытаетесь передать в метод text("") пустую строку или null.

Я попробовал Selenide 5.13.0 на своём рабочем проекте и внезапно нашёл тестов 20-30, которые падали с этой ошибкой. И это всё были логические ошибки в тестах! Вот какое полезное изменение вас ждёт. :)

См. issue 1156.
Спасибо Roman S.A. за PR 1186.

UPD
Позже мы добавили настройку FULL_TEXT, заставляющую Selenide проверять строку целиком, на не подстроку.

Убрали лишние логи из аллюра

Внимательные аллюровцы заметили, что селенид логирует одно и то же действие дважды. Например, при вызове такой строки:

  $(bySelector).findAll(BySelector).filter(condtion);

(на самом деле не только в аллюре, но и в обычном селенидовском TextReport)

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

См. issue 997 и PR 1193.

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

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

См. issue 967 и PR 1189.

Починили загрузку файлов вне тэга `<form>`

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

  $("input").uploadFile(
    new File("a.txt"),
    new File("b.txt"),
    new File("c.txt")
  );

Для этой загрузки мы в своё время сделали в селениде хитрый JS хак. Оказалось, что этот хак предполагал, что <input> для загрузки файла должен быть внутри тэга <form>. Что как бы логично.
Но оказалось, что не у всех так.

В общем, теперь мы упростили хак и убрали зависимость от тэга <form>.

См. issue 943 и PR 1188.

Научились скачивать файлы с кавычками в имени

… и другими нехорошими символами.

Оказывается, есть и такие чудаки, которые генерируют файлы, в имени которых есть кавычки. Линукс и Мак вполне умеют сохранять такие файлы, а вот винда никак. Теперь селенид заменяет кавычки и другие нехорошие символы на подчёркивания (как делают все основные браузеры).

См. issue 1196 и PR 1199.

Научили вебдрайвер писать свои логи в файл

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

Теперь же селенид включает логи вебдрайвера. Логи пишутся в файлы вида build/reports/tests/webdriver.ts_pid_tid.log.
Полный путь к файлу вы можете узнать из лога, который пишет селенид каждый раз при открытии браузера:

INFO Write webdriver logs to: /andrei/build/reports/tests/webdriver.1594248139109_18125_1.log

Когда в следующий раз будете изучать аномальное поведение вебдрайвера, не забудьте туда заглянуть.

См. issue 1206 и PR 1207.

Добавили новый способ скачивания файлов `FOLDER`

Как вы знаете, до сих пор в селениде было два способа скачивания файлов: HTTPGET и PROXY. См. пост в нашем блоге.

HTTPGET - самый простой и надёжный. Но умеет скачивать только файлы с ссылки вида <a href>.
PROXY - универсальный и мощный способ. Но при удалённом запуске требует доступа с машины браузера к машине тестов. Что порой вызывает сложности и поклонников Селеноида и Грида.

Теперь появился третий способ: FOLDER.

Чтобы его включить, просто пропишите в начале тестов:

Configuration.fileDownload = FileDownloadMode.FOLDER;

Работает он просто:

Кликает элемент
Смотрит, какие новые файлы появились в папке build/downloads
Если таких файлов несколько, пытается угадать, какой из них подходит лучше всего.

Рабочий пример всегда можно найти в тестах самого селенида.

P.S. Будем пока считать этот способ экспериментальным, поскольку есть нюансы:

Работает надёжно при локальном запуске в один поток
При параллельном запуске одновременные тесты могут скачивать файлы в одну и ту же папку, и тогда селенид не сможет определить, кому какой файл отдать.
При удалённом запуске этот способ вообще пока не работает. Тесты-то здесь, а папка там!
Поддерживаются Chrome, Firefox, Edge, Opera. Не поддерживаются IE и Safari (у в принципе нет возможности задать папку для скачивания файлов).

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

См. issue 1212, PR 1213 и PR 1215.

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

Метод `$.getWrappedElement()` снова ждёт появления элемента

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

Допустим, у вас есть такой код:

SelenideElement button = $("button");
executeJavascript("arguments[0].click()", button);

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

В общем, теперь мы вернули обратно старое поведение. Теперь снова ждёт.

См. issue 1191 и PR 1203.

Обновились до BrowserUpProxy 2.1.1

Ну вдруг.

Обновляйтесь, пробуйте, делитесь впечатлениями!

Статистика

И моё любимое: статистика скачиваний селенида.
Мы пробили потолок в 160 тысяч в месяц!

и 31+ тысяча уникальных айпишников:

Жизнь хороша!

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

ru.selenide.org

Вышла Selenide 5.12.2

2020-05-29T00:00:00+00:00

Всем привет!

Ловите ещё один мини-релиз Selenide 5.12.2.

Подправили аннотации @Nonnull

… для некоторых методов SelenideElement.

После обновления на Selenide 5.12.0 некоторые пользователи котлина начали жаловаться, что их проекты переставил компилироваться.
Всё дело в том, что мы пометили все методы SelenideElement аннотациями @Nullable/@Nonnull, а котлин к ним чуток.

Для следующих методов мы теперь прописали @Nonnull, потому что дополнительная проверка показала, что они никогда не возвращают null:

$.getText()
$.text()
$.innerText()
$.innerHtml()
$.getSelectedText()

Теперь в котлине их можно по-прежнему пихать в ненулевые переменные (хоть мне и кажутся сомнительными такие конструкции в тестах).

См. issue 1179 и PR 1181.

Исправили работу настройки `holdBrowserOpen=true`

Эта настройка срабатывала не всегда. Уже давно.
И мы давно об этом знали, но забывали, потому что никто нам issue на гитхабе не заводил. :(

В общем, исправили. При заданной настройке Configuration.holdBrowserOpen=true браузер остаётся открытым после окончания тестов и вообще всех потоков.

См. issue 1172 и PR 1176.

Видосики

Видео Тяжелое утро с Heisenbug #2 со мной. Вопросы, до которых обычно на конференциях не до.
Всеволод Брекелов и Артём Ерошенко в “Ошибке выжившего #4” в прямом эфире пишут экспорт Record&Play в Selenide. Представляете!
Мы опубликовали Selenide Roadmap. Ждём ваших отзывов!

Новости

Ура!

Свершилось!

Мы опубликовали плагин для Selenium IDE, который умеет экспортировать код в Selenide.

Мы скоро напишем об этом отдельную статью.

Большое спасибо Dmytro Stekanov за этот исторический для селенида момент!

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

ru.selenide.org

Вышла Selenide 5.12.1

2020-05-25T00:00:00+00:00

Всем привет!

По горячим следам вы выпустили багфикс релиз Selenide 5.12.1 с парочкой мелких исправлений для Selenide 5.12.0.

Исправили Concurrent modification exception при инициализации вебдрайвера

См. issue 1170 и PR 1171.

Исправили мержинг настройки “excludeSwitches” разных типов

Оказывается, настройку excludeSwitches можно задать и как массив, и как список:

  chromeOptions.setExperimentalOption("excludeSwitches", new String[]{"enable-automation", "load-extension"});
  chromeOptions.setExperimentalOption("excludeSwitches", asList("enable-automation", "load-extension"));

Селенид 5.12.0 ломался, если задать вперемежку и так, и так. Починили.

См. issue 1169 и PR 1174.

Новости

Мы опубликовали Selenide Roadmap. Ждём ваших отзывов!
Видео с митапа pro:TEST - Чехия, 28.04.2020
Видео с митапа QA meetup - Словакия, 12.05.2020
Всеволод Брекелов и Артём Ерошенко запустили шоу “Ошибка выжившего”. Я посмотрел первые 4 выпуска - годно!
Ребята и девчонки из jug.ru запустили шоу “Тяжелое утро с Heisenbug”.
Ближайший выпуск будет со мной, ура-ура! 27 мая 2020

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

ru.selenide.org

Вышла Selenide 5.12.0

2020-05-23T00:00:00+00:00

Всем привет!

Ура, релиз Selenide 5.12.0.

Большая часть изменений касается настроек браузеров.

Порешали старинную проблему с `Configuration.browserCapabilities`

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

Но кажется, нам удалось найти простой костыль.

Если вам помогло - делитесь.
Если не помогло - тем более делитесь, будем докостыливать дальше.

См. issue 676, issue 1097 и PR 1155.

Отдельное спасибо за попытки, которые не попали в релиз, но навели нас на итоговое решение:

Спасибо Boris Osipov за PR #1103
Спасибо SeleniumTestAB за PR #1095

Выключили раздражающий диалог “save password?”

См. issue 1133 и PR 1134.

Добавили режим “эмуляции мобильника” в гриде

Как вы знаете, в Selenide 5.6.1 появилась возможность запускать хром в режиме “эмуляции мобильного браузера”:

java -Dchromeoptions.mobileEmulation="deviceName=Nexus 5"

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

См. issue 1109 и PR 1163.

Упростили сетап Firefox: теперь без профиля

При открытии браузера Firefox селенид создавал ему профиль (FirefoxProfile) - как минимум, чтобы задать папку для скачивания файлов.
Оказалось, что использование профиля накладывает некоторые ограничения, и вообще не нужно (вроде как когда-то он был нужен для legacy firefox driver).

Теперь мы по умолчанию обходимся без профиля:

Папку для скачивания файлов создаём через firefoxOptions.addPreference("browser.download.dir")
Создаём профиль, только если вы специально задали системные свойства, начинающиеся на "firefoxprofile.".

См. issue 1139 и PR 1165.

Задаём настройку `"ACCEPT_INSECURE_CERTS"` для версий Edge, построенных на движке chromium

Начиная с какой-то версии, браузеры IE и Edge перестали поддерживать настройку "ACCEPT_INSECURE_CERTS" (разрешение самоподписанных SSL сертификатов). И мы выпилили эту настройку для IE и Edge (в Selenide 5.9.0).

Но оказалось, что более поздние версии Edge, которые построены на движке Chromium, снова начали её поддерживать.
Поэтому мы вернули настройку "ACCEPT_INSECURE_CERTS" для версий Edge 75 и выше.

Важно: версию Edge селенид может узнать, только если EdgeDriver был скачан с помощью WebDriverManager (что в селениде случается по умолчанию).

См. issue 1093 и PR 1167.

Обновились на WebDriverManager 4.0.0

Поддержка Firefox 76
Поддержка Edge 81, 83, 84
Обновили Apache HttpClient с 4.x на 5.0

См. PR 1149 и WDM Changelog.

Обновились на browserup-proxy-core:2.1.0

Ну мало ли.

Исправили имя папки для скриншота ‘emptyMethod’

Проблема касалась только JUnit 5.

Спасибо Denis Gaievsky за PR 1138

Расставили аннотации `@Nullable` и `@Nonnull`

Это поможет IDEA (и надеюсь, другим IDE) лучше подсвечивать косяки в ваших тестах.
А также это поможет пользователям Kotlin правильно использовать nullable/non-nullable типы.

И снова спасибо Yuriy Artamonov за PR 1140 и PR 1144!

Новости

Мы опубликовали Selenide Roadmap. Ждём ваших отзывов!
Видео с митапа pro:TEST - Чехия, 28.04.2020
Видео с митапа QA meetup - Словакия, 12.05.2020
Всеволод Брекелов и Артём Ерошенко запустили шоу “Ошибка выжившего”. Я посмотрел первые 4 выпуска - годно!
Ребята и девчонки из jug.ru запустили шоу “Тяжелое утро с Heisenbug”.
Ближайший выпуск будет со мной, ура-ура! 27 мая 2020

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

ru.selenide.org

Вышла Selenide 5.11.1

2020-04-21T00:00:00+00:00

Всем привет!

Похоже, релиз Selenide 5.11.0 всё-таки сломал слишком много устоев, и мы решили сбавить обороты. :)

Меняем ваше возмущение на Selenide 5.11.1.

SLF4J

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

Для нас это было неожиданно, но мы идём навстречу трудящимся.

Теперь селенид требует slf4j не всегда, а только в тех редких случаях, когда без него точно никак. А именно, если вы включите фичу TextReport.

because we can!

В Selenide 5.11.0 мы сделали одну (почти незаметную) багу, связанную с использованием because. А именно,

$("blah").shouldNot(exist) - не падает (это ок)
$("blah").shouldNot(exist.because("we can")) - падает (а вот это не ок)

Слово because оказалось несовместимым с отрицанием. Теперь мы это исправили, и обе строчки не падают.

См. issue 1130 и 1131.

Сбросили 16 мегабайт

Оказывается, среди зависимостей селенида затесался 16-мегабайтный файл checker.jar.
Мы с лёгкостью от него избавились.

Спасибо Yuriy Artamonov за PR 1128.

Новости

Во вторник 28 апреля я буду выступать на чешском митапе [pro:]TEST!
Поскольку митап онлайн, участвовать будут все желающие. Можете позвать друзей, которые ещё не знают про селенид!

Язык: ломаный английский
Дата: 28.04.2020, 18:00 GMT+2
Уровень: скорее для начинающих
Ссылки: Анонс / Трансляция

Добро пожаловать!

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

ru.selenide.org

Вышла Selenide 5.11.0

2020-04-19T00:00:00+00:00

Всем привет!

Мы выпустили Selenide 5.11.0.
Это уже второй карантинный релиз Selenide. И чтобы вам не засохнуть от скуки, мы сделали парочку существенных изменений.

Поменяли поведение `shouldNot*` проверок для несуществующего элемента

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

Проверка	Selenide 5.10-	Selenide 5.11+
`h1.shouldNot(exist)`	ok	ok
`h1.shouldNotBe(visible)`	ok	ok
`h1.shouldBe(hidden)`	ok	ok
`h1.shouldNotHave(text("foo"))`	ok	FAIL
`h1.shouldNotHave(attribute("bar"))`	ok	FAIL
`h1.find("h2").shouldNot(exist)`	ok	ok
`h1.find("h2").shouldNotHave(text("foo"))`	ok	FAIL

Старая логика

Когда-то давно в селениде было принято такое решение: проверка h1.shouldNotHave(text("foo")) не должна падать: нет элемента - нет и текста. Значит, условие “should not” выполнено.

Эту логику подкрепляло и такое соображение: проверка h1.shouldHave(text("foo")) валится, а “shouldNot” - её отрицание, поэтому она валиться не должна.

Новая логика

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

См. issue 368 и PR 1116.

Теперь Селенид ругается, если SLF4J не настроен

Если вы увидите такое сообщение:

java.lang.IllegalStateException: SLF4J is not configured. You will not see any Selenide logs. 
  Please add slf4j-simple.jar, slf4j-log4j12.jar or logback-classic.jar to your classpath. 
  See https://github.com/selenide/selenide/wiki/slf4j

то не пугайтесь - просто сделайте, что там сказано. Это очень просто.

Какую проблему мы решали?

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

См. issue 1114 и PR 1115.

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

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

наличия атрибута, и
точного значения атрибута:

  $("#domain-container").shouldHave(attribute("class"));
  $("#domain-container").shouldHave(attribute("class", "container"));

Теперь мы добавили метод attributeMatching для проверки частичного значения атрибута.
См. примеры в тестах:

@Test
void canVerifyAttributeMatching() {
  $("#domain-container").shouldHave(attributeMatching("class", "contain.*"));  // class="container"
  $("#domain-container").shouldHave(attributeMatching("class", ".*tainer"));
  $("#domain-container").shouldHave(attributeMatching("class", ".+tain.+"));
}

См. issue 996.
Спасибо Dmytro Stekanov за PR 1100.

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

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

Screenshots.getLastThreadScreenshot() - возвращает последний скриншот, сделанный селенидом в текущем потоке
Screenshots.getThreadScreenshots() - возвращает все скриншоты, сделанные селенидом в текущем потоке

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

См. issue 1029.
Спасибо Dmytro Stekanov за PR 1125.

Добавили аннотацию `@CheckReturnValue` к большинству публичных методов селенида

Это позволит IDE (как минимум Intellij IDEA) лучше анализировать код ваших тестов и предупреждать, если вы вызвали какой-нибудь селенидовский метод, но забыли проверить результат:

Спасибо Yuriy Artamonov за PR 1106.

Добавили нехватающий метод `Selectors.byTagName()`

Просто чтобы было консистентно с By.

Спасибо Yuriy Artamonov за PR 1104.

Исправили URL скриншота

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

См. issue 1072.
Спасибо Dmytro Stekanov за PR 1098.

Отключили предупреждение о расширениях в Chrome

Честно говоря, я так и не понял, при каких условиях это предупреждение появляется - лично я его не видел:

Но некоторые товарищи жаловались. Теперь мы его отключили вот такой настройкой:

options.setExperimentalOption("excludeSwitches", new String[]{"enable-automation", "load-extension"});

Дайте знать, если у вас это вызовет какие-то проблемы.

См. issue 1119 и PR 1120.

Теперь можно установить `selectorMode` и `assertionMode` через системные свойства

Никто этого не просил - просто для консистентности.

См. коммит 231597eb6229e.

Метод `$.getWrappedElement()` больше ничего не ждёт

Подозреваю, что большинство из вас не знали о существовании этого метода и тем более не использовали его.
Его идея была в том, чтобы дать автору теста доступ к оригинальному селениумовскому WebElement без всякой селенидовской магии (ну мало ли кому-то понадобится). А Iakiv Kramarenko заметил, что без селенидовской магии не обошлось: метод $.getWrappedElement() всё-таки ждал появления элемента.

Теперь он больше ничего не ждёт. Если элемента нет - он сразу кидает селениумовский org.openqa.selenium.NoSuchElementException. Ну и легендарный StaleElementReferenceException вы тоже можете отхватить, конечно (ну мало ли кому-то захочется вспомнить молодость).

См. issue 1015 и PR 1124.

Статистика

И моё любимое: статистика скачиваний селенида. Мы пробили потолок в 130 тысяч в месяц!

и 23 тысячи уникальных айпишников:

Жизнь хороша!

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

ru.selenide.org

Вышла Selenide 5.10.0

2020-03-18T00:00:00+00:00

Здоровендос!

Шёл третий день карантина.

Чтобы вам не было одиноко, мы выпустили Selenide 5.10.0 с кучей улучшений, некоторые из которых даже окажутся капельку обратно несовместимыми. Ну, чтобы вы не скучали в своих берлогах.

Добавили поддержку Shadow DOM

См. примеры в тестах:

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

$(shadowCss("p", "#shadow-host")).shouldHave(text("Inside Shadow-DOM"));

$(shadowCss("p", "#shadow-host", "#inner-shadow-host")).shouldHave(text("The Shadow-DOM inside another shadow tree"));

Firefox: Вызов setValue("test") / val("text") на input элементе выкидывает ошибку “not reachable by keyboard”.
Как временное решение, можно использовать fastSetValue=true:

Configuration.fastSetValue = true;
$(shadowCss("input", "#shadow-host")).setValue("test");

См. issue 1014.
Спасибо Dmytro Stekanov за PR 1090.

Selenide больше не тянет BrowserUpProxy по умолчанию

Изначально это предложил Алексей Баранцев, так что бейте его, если что. :)

Мы сопоставили вместе два факта:

Селенид по умолчанию тянет за собой BrowserUpProxy и его зависимости - всего ~17 мегабайт.
Большинство пользователей (наверное) не использует селенидовский прокси.

и решили обрадовать Грету Тумберг и не качать эти 17 мегабайт по умолчанию.

Зависимость

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

testRuntime 'com.browserup:browserup-proxy-core:2.0.1'

(у многих из вас она и так уже есть).

Если вы забудете добавить зависимость - не беспокойтесь, вы увидите понятное сообщение:

java.lang.IllegalStateException: Cannot initialize proxy. Probably you should add BrowserUpProxy dependency to your project.
    at com.codeborne.selenide.drivercommands.CreateDriverCommand.createDriver(CreateDriverCommand.java:44)
    ...
    at com.codeborne.selenide.Selenide.open(Selenide.java:41)
caused by: java.lang.NoClassDefFoundError: com/browserup/bup/BrowserUpProxy

См. issue 1021 и PR 1094.

UPD 12.03.2023 В наше время больше не нужно добавлять ту зависимость browserup-proxy-core. Просто используйте com.codeborne:selenide-proxy вместо com.codeborne:selenide, и все нужные зависимости подтянутся автоматически.

Просто из интереса

Кто же там сжирает эти 17 мегабайт, спросите вы? А вот кто.
Вот полный список файлов, которые должны у вас пропасть из проекта. Список впечатляет, правда?

animal-sniffer-annotations-1.17.jar
barchart-udt-bundle-2.3.0.jar
bcpkix-jdk15on-1.62.jar
bcprov-jdk15on-1.62.jar
browserup-proxy-core-2.0.1.jar
browserup-proxy-mitm-2.0.1.jar
checker-qual-2.5.2.jar
dec-0.1.2.jar
dnsjava-2.1.9.jar
error_prone_annotations-2.2.0.jar
failureaccess-1.0.1.jar
guava-27.1-jre.jar
jackson-annotations-2.9.9.jar
jackson-core-2.9.9.jar
jackson-databind-2.9.9.1.jar
javassist-3.25.0-GA.jar
javax.activation-api-1.2.0.jar
jaxb-api-2.3.1.jar
jcl-over-slf4j-1.7.28.jar
jsr305-3.0.2.jar
jzlib-1.1.3.jar
listenablefuture-9999.0-empty-to-avoid-conflict-with-guava.jar
littleproxy-2.0.0-beta-5.jar
netty-all-4.1.39.Final.jar

Кто придумал название “animal-sniffer”? Это что вообще такое - нюхальщик животных?

Поменяли Guava API на соответствующие Java API

Мы просто поменяли

com.google.common.base.Predicate из Guava
на java.util.function.Predicate из Java 8

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

Если вы реализовали свои CollectionCondition, вам придётся метод apply переименовать в test. Это должно быть легко.

См. issue 1091.
Спасибо Wladimir Schmidt за PR 1091.

Сделали селенидовский отчёт в Allure чуточку красивее

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

См. issue 1032.
Спасибо Dmytro Stekanov за PR 1092.

Добавили условие `$("img").shouldBe(image)`

Позволяет проверить, что картинка есть, она загрузилась и всё в порядке.

См. примеры в тестах:

$("#valid-image img").shouldBe(image);
$("#valid-image").shouldNotBe(image);
$("h1").shouldNotBe(image);

См. issue 1069.
Спасибо Dmytro Stekanov за PR 1086.

Исправили поиск элементов по атрибуту, который содержит кавычки

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

См. issue 1060.
Спасибо Denys Lystopadskyy за PR 1062.

Видосики

Немногие задумывались об этом, но возможно, SeleniumCamp 2020 - Последняя Конференция Человечества.

Но они ещё и последние альтруисты человечества, потому что из-за карантина они досрочно выложили все видео с последней конференции в открытый доступ.
Лечитесь, айтишники, и просвещайтесь!

Там есть три моих доклада:

Flaky tests: The method
BOF: прошлое и будущее селенида
Тройничок: Selenide для Web, Android и iOS – “Толерантные локаторы”!

И ещё из того, что я успел заметить:

Aleksei Tiurin - Solving the problems of Espresso Android autotests
Michael Bodnarchuk - Puppeteer is a new WebDriver? Secrets of flawless testing.
Oleksandr Khotemskyi - WebdriverIO + Puppeteer. Double gun – double fun
Sergey Pirogov - Test coverage myth busted
Mikalai Alimenkou - Static analysis tools as the best friend of QA

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

ru.selenide.org

Вышла Selenide 5.9.0

2020-03-10T00:00:00+00:00

Здоровендос!

По всему миру объявлена пандемия flaky тестов, и мы ищем новые лекарства для борьбы с ними.

Сегодня мы выпустили Selenide 5.9.0 с одной фичей, которая может помочь справиться с моргающими тестами.

Добавили фильтр для скачивания файлов: `$.download(FileFilter)`

Проблема

При скачивании файлов через прокси селенид может иногда скачать не тот файл.
Селенид ведь как скачивает файлы: кликает на кнопку “Скачать” и перехватывает ответ сервера браузеру.

Но иногда в этот момент между браузером и сервером могут лететь какие-нибудь левые запросы, никак не связанные со скачиванием. Например, хром решает проверить обновления. Или ваше приложение шлёт запросы в google analytics. Или просто какие-то фоновые запросы. Это создаёт плодотворную почву для появления flaky тестов, которые у вас на машине работают, а на дженкинсе иногда падают.

Решение

Чтобы избежать таких коллизий, теперь вы можете явно указать, какой файл вы ждёте.
Из коробки есть фильтры по имени и расширению файла, но вы можете создавать свои объекты FileFilter с какими угодно критериями.
И тогда из всех ответов сервера браузеру селенид выберет тот, который подходит под ваш фильтр.

См. примеры в тестах:

File f1 = $("#downloadMe").download(withName("hello_world.txt"));
File f2 = $("#downloadMe").download(withNameMatching("hello_.\\w+\\.txt"));
File f3 = $("#downloadMe").download(timeout, withExtension("txt"));

См. issue 1065 и PR 1080.

Исправили ошибку при старте IE 3.150

См. issue 1061.
Спасибо Boris Osipov за PR 1075.

Исправили ошибку при старте Microsoft Edge

См. issue 1039.
Спасибо Boris Osipov за PR 1084.

Новости

Забавный диалог получился в твиттере: контрибьютор проектов Selenium и Watir Titus Fortner признался, что видел мой доклад про селенид на SeleniumConf и спёр оттуда несколько идей для Watir, а я признался, что некоторые вещи в селениде изначально были спёрты из Watir.
Хорошая статья Modern Best Practices for Testing in Java. Масса правильных мыслей.
Статья Selenide Test Automation: Using Selenoid in the Docker Container
Статья Parametrized UI testing with Selenide and Junit 5
Некий базовый проект qa-automation-base, в котором намешаны Kotlin + Selenide/Appium + JUnit 5 + Allure + Allure EE + TestRail.

Статистика

Ну и на десерт - статистика скачиваний селенида. Растём!

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

ru.selenide.org

Вышла Selenide 5.8.0

2020-02-28T00:00:00+00:00

Приветос!

Мы подбили ещё пачку пуллреквестов и выпустили Selenide 5.8.0.

Какие же обновления нас ждут?

Упростили создание своих условий с помощью лямбд

В классе Condition появился новый метод match, который позволяет добавлять свои проверки, не создавая подклассов Condition. Ему надо просто скормить лямбду.

См. примеры в тестах:

$("#multirowTable").should(match("border=1", el -> el.getAttribute("border").equals("1")));

Также появились похожие методы для коллекций anyMatch, allMatch и noneMatch. См. примеры в тестах:

$$("input").shouldBe(anyMatch("value==dog", el -> el.getAttribute("value").equals("dog")));
$$("input").shouldBe(allMatch("value==cat", el -> el.getAttribute("value").equals("cat")));
$$("input").shouldBe(noneMatch("value==bird", el -> el.getAttribute("value").equals("bird")));

См. issue 662.
Спасибо Dmytro Stekanov за PR 1059.

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

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

См. примеры в тестах:

$("#multirowTableFirstRow").sibling(0).shouldHave(id("multirowTableSecondRow"));
$(".second_row").parent().preceding(0).find("td", 0).shouldHave(cssClass("first_row"));

См. issue 845.
Спасибо Dmytro Stekanov за PR 1064.

Запилили поддержку псевдо-элементов

Как многие знают, в HTML есть такие штуковины как псевдо-элементы: “:before”, “:after”, “:first-letter”, “:first-line”, “:selection”. Они могут содержать важный текст и стили, которые иногда важно протестировать. Теперь вы можете это сделать.

См. примеры в тестах:

$("h1").shouldHave(pseudo(":first-letter", "color", "rgb(255, 0, 0)"));
$("abbr").shouldHave(pseudo(":before", "content", "\"beforeContent\""));
$("abbr").shouldHave(pseudo(":before", "\"beforeContent\""));

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

assertThat($("h1").pseudo(":first-letter", "color")).isEqualTo("rgb(255, 0, 0)");
assertThat($("abbr").pseudo(":before")).isEqualTo("\"beforeContent\"");

См. issue 994.
Спасибо Denys Shynkarenko за PR 1045.

Исправили SoftAssertionsExtension для JUnit5

Если один из тестов падал, он помечал и все последующие тесты красным. Упс.

См. issue 1071.
Спасибо Alexei Vinogradov за исправление.

Теперь `$.click()` кликает всегда в ЦЕНТР элемента

В общем, история такая. Метод $.click() обычно кликал в центр элемента, НО если у вас проставлена настройка Configuration.clickViaJS=true, он кликал в левый верхний угол. Не то чтобы это было принципиально важно, но мало ли… Теперь он всегда кликает по центру. На всякий случай. Чтобы всегда всё вело себя одинаково.

См. коммит 106c53941c718.

Новости

Представляете, доклад Алексея Виноградова Selenide: Брандашмыг — интерактивное путешествие по дорогам библиотеки занял 3 место в ТОП-10 докладов Heisenbug 2019 Moscow. Это успех!
Ничего себе! John C. Pratt создал экспортер в Selenide для Katalon Recorder (работает с Katalon Recorder). Это дикий успех!
Обнаружен phpSelenide - порт Селенида на PHP. Это усPHPех!
И если кто ещё не видел, SeleneJS - порт Селенида на JS. Это уех!

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

ru.selenide.org

Вышла Selenide 5.7.0

2020-02-07T00:00:00+00:00

Приветос!

Неожиданно нас завалили пуллреквестами с кучей полезных изменений. В этом сила опенсорса!

Мы подбили всё это в кучу и выпустили Selenide 5.7.0.

Мы добавили новую настройку `Configuration.downloadsFolder`

Раньше файлы скачивались в папку build/reports - в ту самую, где генерируются отчёты о прохождении тестов.
А людям иногда хочется разделять (и властвовать?).
Для них мы сделали отдельную настройку Configuration.downloadsFolder - именно туда теперь будут сохраняться файлы.

По умолчанию это папка build/downloads.

См. issue 1025.
Спасибо Dmytro Stekanov за PR 1041.

Скачиваем файлы в `Configuration.downloadsFolder` вместо `~/Downloads`

Со скачиваниями файлов через прокси (Configuration.fileDownload=PROXY) есть ещё одна особенность.
Селенид-то свои файлы скачивает в build/reports (а теперь в build/downloads), но сам-то браузер тоже скачивает свою копию файла в папку ~/Downloads (или что там у него по умолчанию). Во-первых, тратится лишнее место на диске, а во-вторых, оттуда эти файлы никто автоматически не подчищает.

Теперь селенид изначально открывает браузер с такими настройками, чтобы он сразу скачивал файлы в папку build/downloads.

Правда, пока только Chrome и Firefox.
И только в случае, когда селенид сам открывает браузер.

См. issue 1057. Спасибо Dmitri Korobtsov за ревью PR 1058.

Добавили метод для переключения между окнами с кастомным таймаутом

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

switchTo().window(3);

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

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

switchTo().window(3,  Duration.ofSeconds(42));
switchTo().window(3,  Duration.ofMillis(16000));

См. issue 399.
Спасибо Dmytro Stekanov за PR 1054.

Добавили логирование атрибута “readonly”

См. issue 990.
Спасибо Dmytro Stekanov за PR 1042.

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

… при поиске первого/последнего элемента пустой коллекции

См. issue 991.
Спасибо Dmytro Stekanov за PR 1043.

И целая пачка улучшений скриншотов

1. Вернули потерянные скриншоты в `Screenshots.getLastScreenshot()`

См. issue 814 и issue 880.
Спасибо Petro Ovcharenko за PR 1052.

2. Исправили ссылки на скриншоты в Jenkins

Теперь селенид умеет читать переменную среды (env variable) BUILD_URL, и вам больше не нужно прописывать BUILD_URL в system properties в ваших билд-скриптах.

Спасибо GongYi за PR 1049.

3. Исправили ссылки на скриншоты в Jenkins для мультимодульных проектов Maven

Спасибо GongYi за PR 1049.

Обновились на WebDriverManager 3.8.1

См. changelog (в т.ч. поддержка Edge 80).

Мероприятия

SeleniumCamp 2020

Приезжайте в Киев 21-22 февраля на конференцию SeleniumCamp!
Я буду выступать с двумя докладами:

и ещё будет неформальная сессия BOF про дальнейшие планы развития Селенида.

Митап про Селенид в Германии

Какие-то черти запилили митап про Селенид в Германии 12 февраля.
Приятно, чо.

Статистика

Количество скачиваний селенида за год выросло в 2.5 раза с 40 тысяч до 110 тысяч.

А количество уникальных айпишников перевалило за 20 тысяч:

Мы растём!

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

ru.selenide.org

Вышла Selenide 5.6.1

2020-01-14T00:00:00+00:00

Всех с Новым Годом!

Новый год - новый релиз. Встречайте Selenide 5.6.1.

Добавили метод `Selenide.executeAsyncScript()`

Нет такого человека, который ни разу не запускал бы метод Selenide.executeJavaScript(). JavaScript позволяет выйти на новый уровень сумрака в автоматизации.

А теперь мы добавили ещё и метод Selenide.executeAsyncScript(). Правда, я плохо представляю, в каких случаях он может понадобится, но если кому надо - теперь он есть.

Обратите внимание, его использование сложнее, чем обычного executeJavaScript(). После исполнения асинхронного JS кода нужно вызвать callback с результатом. А callback нужно получить из последнего аргумента:

long value = (Long) Selenide.executeAsyncJavaScript(
      "var callback = arguments[arguments.length - 1]; " + 
      "setTimeout(function() { " + 
      "   // Вот тут любая асинхронная чертовщина: " +
      "   ... " +
      "   // и в конце возврат в селениум: " +
      "   callback(10);" + 
      "}, 5000);"
    );
    assertThat(value).isEqualTo(10);

См. issue 1030.
Спасибо Thierry Ygé за PR 1031.

Научили Selenide скачивать через прокси файлы без заголовка `Content-Disposition`

Как вы знаете, Selenide умеет скачивать файлы через свой прокси. Но при скачивании он перехватывал только те ответы сервера, в которых присутствует заголовок Content-Disposition (чтобы узнать оттуда имя скачиваемого файлы).

Как выяснилось, этот заголовок необязателен. Файлы могут скачиваться и без него.

Теперь селенидовский прокси стал умнее.

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

А имя файла (в случае ответа без заголовка Content-Disposition) берётся просто из URL.

См. issue 1034 и PR 1035.

Исправили метод `WebDriverRunner.using()`

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

См. коммит 4d1b19972d.

Обновились на WebDriverManager 3.8.0

там было исправлено несколько ошибок, в т.ч. моего авторства :)

См. changelog.
В частности, WDM теперь должен корректно работать без доступа в интернет.

Новости

Огонь! Selenious - порт селенида на .NET
Ребята обещали, что проект рабочий, они его в реальном проекте используют.
Статья от LambdaTest: Selenide Tests With LambdaTest – Online Selenium Grid For Automated Cross Browser Testing
Моё видео с октябрьской конференции Cyprus Quality Conference Threesome: Selenide for Web, Android and iOS. Не переживайте, в феврале я его буду рассказывать по-русски на SeleniumCamp.
Если кто пропустил, серия постов Selenide Advent Calendar

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

ru.selenide.org

Вышла Selenide 5.6.0

2019-12-26T00:00:00+00:00

Всем привет!

Под конец года мы выпустили Selenide 5.6.0 с одним обновлением.

Мы поменяли BrowserMobProxy (который больше не поддерживается) на его форк BrowserUpProxy (текущая версия 2.0.1).

См. issue 1019.
Спасибо Aliaksandr Rasolka за PR 1020.

Что хорошего в этом `BrowserUpProxy`?

Он

Поддерживает Brotli Compression (а не только gzip)
Поддерживает HTTP/2
Основан на поддерживаемом форке LittleProxy
Использует какой-то улучшенный HAR reader
Умеет фильтровать записи в HAR
Поддерживает версионированные заголовки для JSON типа Content-Type=application/something-v1+json
Имеет встроенные ассерты для сетевых запросов (что это вообще?)

Полный список изменений BrowserUpProxy (по сравнению с BrowserMobProxy) есть тут.

Как нам обновиться?

В большинстве случаев вам не придётся ничего менять. Всё работает как работало.
Изменения потребуются только в двух случаях:

1. Если вы явно импортировали BMP, то вам нужно поменять зависимость

net.lightbody.bmp:browsermob-core:2.1.5

на

com.browserup:browserup-proxy-core:2.0.1

2. Если вы определяли `RequestFilter` или `ResponseFilter`,

то вам придётся поменять импорт

import net.lightbody.bmp.*;

на

import com.browserup.bup.*;

И всё.

Новости

Завезли видео с сентябрьской конференции QA Fest:

Андрей Солнцев. Selenide для профи
Андрей Солнцев. Десять причин моей ненависти
И остальные видео QA Fest 2019
Гугловская статья про принципы DAMP и DRY
Ещё один фреймворк на базе Selenide: JustTestLah! (JTL) - Помесь BDD, Selenide, Appium для Android, iOS и Web
Если кто пропустил, серия постов Selenide Advent Calendar

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

ru.selenide.org

Трюки с JavaScript

2019-12-24T00:00:00+00:00

Привет!

На дворе 24 декабря, католическое рождество. А это значит, что Advent Calendar подошёл к концу.

И напоследок мы поиграемся с JavaScript.

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

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

Выбрать дату

Есть масса всевозможных элементов для выбора даты - т.н. “date picker”. И выбрать в них нужную дату - это вечная головная боль.

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

@Test {
  setDateByName("recurrent.startDate", "16.01.2009");
}

Придётся сделать примерно следующие шаги:

Тыкнуть иконку “календарик”
Тыкнуть год
Тыкнуть стрелку “месяц назад” (сколько раз?)
Тыкнуть день
Ой, фсё, сегодня 29 февраля. Тест упал.

Долго, сложно, ненадёжно.

А вот как этот метод можно реализовать с помощью JS:

void setDateByName(String name, String date) {
  executeJavaScript(
    String.format("$('[name=\"%s\"]').val('%s')", 
    name, date)
  );
}

Быстро и надёжно.

Возможно, вам смутит, что это не совсем “честный” способ. Но об этом мы поговорим в конце. Не переключайтесь.

Спрятать календарик

Допустим, календарик всё же открылся. Как его спрятать? Решение в лоб - тыкнуть крестик в углу. Опять же, это медленно и ненадёжно:

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

Идиотская ситуация.

А вот как этот метод можно реализовать с помощью JS:

executeJavaScript(
  "$('.datepicker').hide();"
);

Быстро и надёжно.

Перелистнуть перелистывалку

Представим себе страницу, на которой есть “перелистывалка” карт. Нужно выбрать нужную карту, двигая наманикюренным пальчиком.
Как сэмулировать это селениумом?
Можно, конечно. Всякие там Drag’n’Drop, Actions. Нажал, потянул, отпустил. Но всё это медленно и нестабильно.
Это легко может сломаться от малейших изменений дизайна, изменения размерна окна браузера, потери фокуса и т.д.

А вот как можно с помощью JS:

void selectAccount(String accountId) {
  executeJavaScript(
    String.format("$('[data-account-id=\"%s\"]').attr('data-card-account', 'true')", accountId)
  );
}

Это нетривиально. Пришлось поизучать код этой “перелистывалки” и понять, какой JS код она дёргает при перелистывании.
И дёрнуть из теста аналогичный JS код. Придётся поработать головой, но зато это быстро и надёжно.

Выбрать опцию в bootstrap select

Многие UI фреймворки заменяют стандартный <select> на какие-то свои самодельные супер-пупер красивые/динамичные/удобные элементы, сварганенные из нагромождения <div>, <span>, <li> и т.п. с кучей разных CSS-классов и стилей. Для автоматизатора это всегда боль.

Один из таких фреймворков - Bootstrap. И в нём тоже есть свой <select>. Мы долго пытались научиться выбирать из него значения: тыкали на один div, ждали появления следующего span, тыкали на него, искали нужный div с правильными атрибутами… Всё это работало долго и часто падало на дженкинсе. Причин падения так до конца и не удалось понять. Хотя мы честно пытались.

В итоге мы реализовали метод

@Test {
  selectBootstrap($(By.name("operationCode")), "11100");
}

с помощью JavaScript:

void selectBootstrap(WebElement select, String value) {
  executeJavaScript(
    "$(arguments[0]).val(arguments[1]).trigger('change')", 
     select, value);
}

Быстро и надёжно.

А с помощью метода execute это можно написать ещё красивее:

$(By.name("operationCode")).execute(selectBootstrap("11100"));

Слайдер

На странице слайдер. Можно таскать ползунок туда-сюда от 0 до 100.
Как это сделать в тесте?

@Test {
  setMaxYearlyFee(100);
}

Тут даже классический Drag’n’Drop не поможет, потому что нет целевого элемента, куда перетаскивать.
Снова Actions, снова нажал-потянул-отпустил (по координатам?), снова медленно и нестабильно.

А можно с помощью JS:

void setMaxYearlyFee(int value) {
  executeJavaScript(
    "$('#sld').data('slider').value[0] = arguments[0];" +
    "$('#sld').triggerHandler('slide');", 
    value
  );
}

Снова пришлось поковыряться в коде, чтобы узнать, какой JS код дёргает слайдер. Зато работает. Зато быстро и надёжно.

Заигнорить чёртов confirm

В Selenide есть удобные методы, чтобы нажать “Ok” или “Cancel” в модальном диалоге alert, prompt или confirm.
Но с этими модальными окошками периодически возникает проблемы. Иногда они почему-то не закрываются, и после этого вебдрайвер не может ничего сделать с браузером, в том числе снять скриншот. Подробнее об этом я рассказывал в видео Flaky tests.

И снова на помощь приходит JavaScript!

Вот так можно “типа нажать Ok” в любом confirm диалоге:

public void mockConfirm() {
  executeJavaScript(
    "window.confirm = function() {return true;};"
  );
}

Плагины Cordova

В одном проекте мы писали гибридное мобильное приложение с помощью фреймворка Cordova.
Он создаёт такое приложение, в котором очень маленькая нативная часть запускает браузер (т.н. WebView), а в нём уже открывает веб-приложение. А доступ к нативным функциями мобильника (контакты, телефон, геолокация и пр.) предоставляет в виде JavaScript-плагинов.

Это очень удобно для тестирования. Для запуска автотестов не нужны реальные мобильники, достаточно открыть урл в обычном браузере (можно ещё и в режиме эмуляции мобильника - вообще не отличишь).

Но вот как тестировать функционал, требующий доступа к нативным функциям мобильника?

И снова на помощь приходит JS. Мы можем эмулировать плагины Cordova, управляя из теста их поведением:

@Test {
  mockContactsAPI("+79110080075");
}

private void mockContactsAPI(String number) {
  executeJavaScript(
    "window.plugins = {" +
    "  contactNumberPicker: { " +
    "    pick: function(callback) {" +
    "      callback({" + 
    "        phoneNumber:\"" + number + "\""
    "  });}}}");
}

Выражение “управлять поведением” кажется диким? Тогда посмотрите видео Arrange, mazafaka! с конференции SeleniumCamp 2018.

А мы имеем функцию mockContactsAPI, которая позволяет “типа выбрать” нужный номер из “типа адресной книги” “типа телефона”.
Собственно, это единственный способ покрыть тестами все возможные случаи: и когда номер найден, и когда не найден, и когда это дубликат, и с 100500 китайскими символами и бог знает какие ещё. Быстро и надёжно.

Но это же не по-настоящему?

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

Понимаю.

Но возражу.

Быстрые и надёжные тесты лучше, чем “реалистичные” (но медленные и нестабильные) тесты.

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

То какой к чёрту прок от ваших “настоящих” тестов?
Один вред.

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

Вы всё ещё хотите возразить:

И всё-таки моей душе спокойнее, когда всё по-настоящему.

Спешу вас огорчить.

Ваши “реалистичные” тесты на Selenium WebDriver по-любому не настоящие. Они работают не так, как реальный пользователь. Вебдрайвер формирует http-запрос на каждую вашу команду и даже - вот сюрприз! - запускает некую логику на JavaScript, чтобы определить видимость элементов и т.п.
О да, в некотором смысле вызов действия через JavaScript даже “реалистичнее”, чем через WebDriver. Это ближе к тому, что на самом деле делает браузер.
И даже ваши ручные тестировщики, прокликивающие ваши сценарии - не настоящие! Они работают не так, как реальный пользователь.

Живите теперь с этим. :)

Что теперь?

А всё. Это был последний пост рождественского календаря. Уффф!

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

Вот такие планы на следующий год.

С наступающим!

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

ru.selenide.org

Defaŭlta lingvo

2019-12-22T00:00:00+00:00

Defaŭlta lingvo

Название сегодняшней темы пришло из языка Эсперанто и означает “язык по умолчанию”.

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

Проблема

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

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

Решение

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

Теперь у вас есть следующие опции:

Поменяйте язык по умолчанию вашей системы. Теперь большинство ваших программ на компьютере заговорят по-немецки. Ordnung muss sein!
Поменяйте в вашем браузере порядок языков так, чтобы самым предпочитаемым стал немецкий. Сохраните профиль браузера. С помощью гугла, напильника и удачи сконфигурируйте тесты так, чтобы профиль загружался перед запуском каждого теста. Да, не забудьте удалить немецкий из топа в списке предпочитаемых языков, иначе, ну вы поняли - Ordnung….
Ну или - просто воспользуйтесь Chrome preference “intl.accept_languages” установив её значение на “de” (немецкий язык).

Разумеется, вы можете легко сделать это в Selenide. Установите значение системной переменной chromeoptions.prefs=intl.accept_languages=de или в коде:

System.setProperty("chromeoptions.prefs","intl.accept_languages=de");

или, лучше, в конфигурационных файлах Maven или Gradle

Maven

maven pom.xml

  ...
  <plugin>
        <artifactId>maven-surefire-plugin</artifactId>
        <version>2.xx.yy</version>
        <configuration>
          <systemPropertyVariables>
            ...
            <chromeoptions.prefs>intl.accept_languages=de</chromeoptions.prefs>
          </systemPropertyVariables>
        </configuration>
    </plugin>
    ...

Gradle

аналогично для Gradle в gradle.properties (вам придётся еще добавить строчку-другую в build.gradle чтобы передать эти параметры в test task грэдла, но про это - в другой раз)

systemProp.chromeoptions.prefs=intl.accept_languages=de

Командная строка

Вы можете переопределять значения при запуске mvn test или gradle test определяя новое значение в -Dchromeoptions.prefs=intl.accept_languages=ru

Пример

Просто запускайте этот маленький тест с различными параметрами языка и понаблюдайте за результатом.

open("http://wikipedia.org");
$("[data-jsl10n=slogan]").shouldHave(exactText("Die freie Enzyklopädie"));

Я желаю всем вам Fröhliche Weihnachten и Guten Rutsch!

Alexei Vinogradov

Теория большого вейта

2019-12-20T00:00:00+00:00

Теория большого вейта

Тема ожиданий вызывает много обсуждений и споров.
Современные веб-сайты создают проблемы для написателей автотестов. Возникает много ситуаций, в которых стандартные методы Selenium неэффективны.

Если вы читали документацию Selenide, вы уже знаете, что классические явные ожидания типа

element = (new WebDriverWait(driver, <timeOutForElement>))
  .until(ExpectedConditions.presenceOfElementLocated(By.cssSelector(<cssSelector>)));

или

element = (new WebDriverWait(driver, <timeOutForElement>))
  .until(ExpectedConditions.visibilityOfElementLocated(By.cssSelector(<cssSelector>)));

были заменены в Selenide более коротким конструкциями типа

element = $(<cssSelector>).should(exist);
element = $(<cssSelector>).shouldBe(visible);

Как известно, ассерты в Selenide - это новая версия явных ожиданий, что хорошо описано в документации.

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

Современные проблемы требуют современных решений

1. `Thread.sleep()`

Это самое ужасное, что может случиться с нашими тестами на Selenium.

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

Если поставить один слип - это ещё ничего. Вы потеряете, скажем, 4 секунды - не смертельно.
Но если вы используете слип в 150 тестах, время их выполнения увеличится заметно.
Нет смысла объяснять, почему это плохо.

Хотя команда sleep() есть и в Selenide, вышеупомянутые “умные ожидания” делают слипы почти ненужными для ожидания появления чего-то либо на странице.
Смотри следующие пункты.

2. Как дождаться окончания загрузки страницы?

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

$(cssSelector).shouldBe(visible);

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

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

$(element).should(disappear);

Таким образом мы создаём двойную проверку, что мы перешли с одной страницы на другую. И это будет работать, даже если загрузка страницы занимает значительное время. Как видите, обошлись без всяких Thread.sleep().

3. Изменение состояния элемента

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

Обычно мы в тесте загружаем файл и проверяем состояние элемента (скажем, текст “файл загружен”).
Но как узнать, когда именно состояние элемента должно поменяться? Загрузка-то происходит не мгновенно.
В этой ситуации многие используют Thread.sleep().

А в Selenide у нас есть умный инструмент для “отложенной” проверки состояния элемента:

$(cssSelector).shouldHave(exactText(<expectedText>));

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

Что теперь?

Мы рассмотрели всего лишь несколько простых идей, как можно “ждать” с помощью Selenide.
В реальности ситуаций намного больше. И здорово, что теперь у нас есть хороший инструмент, позволяющий нам обходится без слипов и не терять драгоценное время.
Используйте умные инструменты и не теряйте время - время ценно. :)

Maciej Grymuza (figrym@gmail.com)

Как получить сетевые запросы с помощью прокси

2019-12-18T00:00:00+00:00

Привет!

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

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

Перед тестом

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

Configuration.proxyEnabled = true;

И ещё нужно сказать прокси-серверу, чтобы он начал отслеживать запросы:

  BrowserMobProxy bmp = WebDriverRunner.getSelenideProxy().getProxy();
    
  // запоминать тело запросов (по умолчанию тело не запоминается, ибо может быть большим)
  bmp.setHarCaptureTypes(CaptureType.getAllContentCaptureTypes());

  // запоминать как запросы, так и ответы
  bmp.enableHarCaptureTypes(CaptureType.REQUEST_CONTENT, CaptureType.RESPONSE_CONTENT);

  // начинай запись!
  bmp.newHar("pofig");

После теста

Теперь нужно получить HAR и анализировать все записи в нём:

    List<HarEntry> requests = bmp.getHar().getLog().getEntries();

HAR (HTTP Archive) - это типа такой “архив” со всеми сетевыми запросами и ответами (“entries”).

Каждая запись - это и есть запрос от тестируемого приложения к серверу.
Внутри есть все данные: URL, request, response, их http status и body.
Всё, о чём мы так давно мечтали.

Плюсы:

Есть все данные, которые нам нужны
Легко анализировать программно
Работает во всех браузерах

Минусы:

Минус только один: иногда у людей возникают сложности с запуском прокси, когда браузер и тесты бегут на разных машинах, и с “браузерной” машины нет доступа к “тестовой” машине. Хотя я никогда не понимал, зачем такие сложности. Запускайте тесты и браузеры на одной и той же машине - ВСЁ будет в стотыщ раз ПРОЩЕ.
Надо параллелить - параллельте тесты. Нужен кластер - запускайте ТЕСТЫ на разных нодах кластера (а с ними запустятся и браузеры). Зачем всё усложнять?

Что теперь?

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

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

ru.selenide.org

Как получить логи браузера через JavaScript

2019-12-17T00:00:00+00:00

Привет!

В прошлом посте нашего рождественского календаря мы пробовали получить логи хрома с помощью капабилити “goog:loggingPrefs”.
А сегодня попробуем другой способ - с помощью JavaScript.

Итак, надо всего лишь в конце теста дёрнуть такой вот JavaScript:

String js = 
   "var performance = window.performance || window.mozPerformance" +
                   " || window.msPerformance || window.webkitPerformance || {};" +
   " return performance.getEntries() || {};";
String netData = executeJavaScript(js).toString();
logger.info("Network traffic: {}", netData);

Результат получается примерно такой:

Network traffic: [
  {name=https://selenide.org/quick-start.html, connectEnd=0, connectStart=0, decodedBodySize=32582, domComplete=724, domContentLoadedEventEnd=119, domContentLoadedEventStart=115, domInteractive=104, domainLookupEnd=0, domainLookupStart=0, duration=724, encodedBodySize=32582, entryType=navigation, fetchStart=0, initiatorType=navigation, loadEventEnd=724, loadEventStart=724, nextHopProtocol=http/1.1, redirectCount=0, redirectEnd=0, redirectStart=0, requestStart=0, responseEnd=0, responseStart=0, secureConnectionStart=0, serverTiming=[], startTime=0, transferSize=0, type=navigate, unloadEventEnd=10, unloadEventStart=9, workerStart=0},
  {name=https://selenide.org/assets/themes/ingmar/css/styles.css?001, connectEnd=12, connectStart=12, decodedBodySize=8177, domainLookupEnd=12, domainLookupStart=12, duration=29, encodedBodySize=8177, entryType=resource, fetchStart=12, initiatorType=link, nextHopProtocol=http/1.1, redirectEnd=0, redirectStart=0, requestStart=12, responseEnd=41, responseStart=21, secureConnectionStart=0, serverTiming=[], startTime=12, transferSize=0, workerStart=0},
  {name=https://ajax.googleapis.com/ajax/libs/jquery/2.1.1/jquery.min.js, connectEnd=13, connectStart=13, decodedBodySize=84245, domainLookupEnd=13, domainLookupStart=13, duration=28, encodedBodySize=84245, entryType=resource, fetchStart=13, initiatorType=script, nextHopProtocol=http/1.1, redirectEnd=0, redirectStart=0, requestStart=13, responseEnd=41, responseStart=21, secureConnectionStart=0, serverTiming=[], startTime=13, transferSize=0, workerStart=0}
]

Плюсы:

Не нужно никак настраивать браузер. Оно работает из коробки.
Работает во всех браузерах (кажется?)

Минусы:

Здесь всё ещё нет тела запроса.
Это невалидный JSON. Распарсить его стандартным парсером не получится. Придётся придумывать какой-то свой обработчик.

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

Что теперь?

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

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

ru.selenide.org

Как получить логи браузера

2019-12-16T00:00:00+00:00

Привет!

Мы продолжаем наш рождественский календарь.
На сей раз мы посмотрим, как можно взглянуть хрому под вкладку “developer tools”.
Это на случай, если вы хотите понять, какие ошибки писались и какие сетевые запросы летели из тестируемого приложения во время прогона тестов.

Chromedriver предлагает следующий рецепт.

1. Добавить щепотку строк при открытии браузера:

LoggingPreferences logPrefs = new LoggingPreferences();
logPrefs.enable(LogType.BROWSER, Level.ALL);
logPrefs.enable(LogType.PERFORMANCE, Level.ALL);
capabilities.setCapability("goog:loggingPrefs", logPrefs);

До какой-то версии эта капабилитя называлась “loggingPrefs”, потом переименовали в “goog:loggingPrefs”.
Не знаю, как в других браузерах.

Кстати, помимо BROWSER и PERFORMANCE, есть и другие типы логов, но у меня они как-то нестабильно работали, да я и пользы в них не увидел. Знаете больше? Делитесь!

2. В конце теста снять пенку с логов:

Logs logs = getWebDriver().manage().logs();
printLog(logs.get(LogType.BROWSER));

void printLog(LogEntries entries) {
    logger.info("{} log entries found", entries.getAll().size());
    for (LogEntry entry : entries) {
      logger.info("{} {} {}",
        new Date(entry.getTimestamp()), entry.getLevel(), entry.getMessage()
      );
    }
  }

3. Блюдо подаётся к отчёту примерно в таком виде:

BROWSER logs:

Mon Dec 16 19:29:42 EET 2019 SEVERE http://localhost:9126/page/image/payment-promo-campaign-ozon.png - Failed to load resource: the server responded with a status of 404 (Not Found)
Mon Dec 16 19:49:14 EET 2019 INFO console-api 19:16 "start loading loans"
Mon Dec 16 19:49:14 EET 2019 INFO console-api 21:18 "loaded loans"

Здесь видны все логи, что есть обычно в Developer Tools -> Console. В том числе сообщения console.log и ошибки JavaScript.

4. Для гурманов можно подать десерт

PERFORMANCE logs:

{"message":{"method":"Network.loadingFinished","params":{"encodedDataLength":0,"requestId":"2C9E49BC49DCD3CA6EA9644255E34DE5","shouldReportCorbBlocking":false,"timestamp":141439.076528}},"webview":"FF1A4E4EAAD7143749CD3740DF9BB95F"}
{"message":{"method":"Page.loadEventFired","params":{"timestamp":141439.234207}},"webview":"FF1A4E4EAAD7143749CD3740DF9BB95F"}
{"message":{"method":"Page.frameStoppedLoading","params":{"frameId":"FF1A4E4EAAD7143749CD3740DF9BB95F"}},"webview":"FF1A4E4EAAD7143749CD3740DF9BB95F"}
{"message":{"method":"Page.domContentEventFired","params":{"timestamp":141439.234834}},"webview":"FF1A4E4EAAD7143749CD3740DF9BB95F"}
{"message":{"method":"Page.frameResized","params":{}},"webview":"FF1A4E4EAAD7143749CD3740DF9BB95F"}
...
{"message":{"method":"Network.dataReceived","params":{"dataLength":0,"encodedDataLength":327,"requestId":"58583.71","timestamp":141474.021635}},"webview":"FF1A4E4EAAD7143749CD3740DF9BB95F"}
{"message":{"method":"Network.loadingFinished","params":{"encodedDataLength":586,"requestId":"58583.71","shouldReportCorbBlocking":false,"timestamp":141473.994219}},"webview":"FF1A4E4EAAD7143749CD3740DF9BB95F"}

Плюс

Каждая запись - это валидный JSON, его вполне можно парсить и анализировать прямо в тестах.

Вот так выглядит отформатированная первая запись:

{ 
   "message":{ 
      "method":"Network.loadingFinished",
      "params":{ 
         "encodedDataLength":0,
         "requestId":"2C9E49BC49DCD3CA6EA9644255E34DE5",
         "shouldReportCorbBlocking":false,
         "timestamp":141439.076528
      }
   },
   "webview":"FF1A4E4EAAD7143749CD3740DF9BB95F"
}

Минус:

Что-то понять из этих логов сложно. Нужно строить поверх какие-то анализаторы.
Здесь нет тела запроса.

Что теперь?

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

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

ru.selenide.org

Drag and Drop

2019-12-15T00:00:00+00:00

Привет!

В сегодняшнем выпуске рождественского календаря мы посмотрим короткое, но весёлое видео о том, как перетаскивать элементы в Selenide.

Селенид умеет перетаскивать элементы?

Да, в селениде есть метод Drag’n’Drop. Вот скучное описание из блога селенида:

  $("#from").dragAndDropTo("#to")

А вот весёленькое описание от Martin Škarbala:

Вот это подача!

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

ru.selenide.org

Actions

2019-12-12T00:00:00+00:00

Привет!

В сегодняшнем выпуске рождественского календаря мы рассмотрим, как можно использовать “действия” (Actions) в Selenide.

Иногда при написании автотестов мы сталкиваемся со странными проблемами. Уверен на 100%, каждый из нас испытывал или будет испытывать необычные проблемы, которые блокируют нашу работу. Например, у нас часто не получается кликнуть на какой-то элемент, и стандартная селениумовская/селенидовская команда типа

  element.click();

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

  WebElement element = <Some selector>;
  Actions actions = new Actions(driver);
  actions.moveToElement(element);
  actions.click();
  actions.build().perform();

Этот вариант иногда срабатывает там, где обычный клик бессилен.

Но как сделать это в Selenide?

Оказывается, в Selenide это ещё проще, чем в Selenium (как, собственно, и всё в Selenide :)).
В Selenide тоже есть Actions:

  SelenideElement element = $(<some selector>);
  actions().moveToElement(element).click(element).perform();

Здесь actions() - это один из тех методов, которые вы можете магически подключить волшебным импортом:

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

Заметить, чтобы использовать actions(), не нужен webdriver!

Чумачечий drag and drop

Если вы читали документацию, вы знаете, что в Selenide по умолчанию есть два типа операций “drag and drop”:

dragAndDropTo(java.lang.String targetCssSelector);
dragAndDropTo(org.openqa.selenium.WebElement target);

Первый метод перетаскивает элемент в цель по CSS локатору. Второй - в другой WebElement.

Но что, если мы не знаем точно, в какой элемент нужно перетащить?
Допустим, у нас есть просто пустая страница, и мы хотим перетащить несколько объектов в разные места на этой странице.
И тут снова на помощь приходят Actions. В Selenium мы бы сделали это примерно так:

  WebElement element = driver.findElement(By.some);
  Actions actions = new Actions(driver);
  actions.dragAndDropBy(element, xOffset, yOffset).perform();

Где xOffset и yOffset - сдвиг по горизонтали и вертикали.

В Selenide это выглядит чуть короче:

  SelenideElement element = <Some selector>;
  actions().dragAndDropBy(element, xOffset, yOffset).perform();

Таким образом мы можем перетащить элемент в любую точку, даже не зная локатора цели.

Что дальше?

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

Наслаждайтесь actions()!

Maciej Grymuza (figrym@gmail.com)

Как скачать файл с помощью Selenide

2019-12-10T00:00:00+00:00

Добрый вечер!

На дворе декабрь, и в сегодняшнем посте рождественского календаря Selenide мы поговорим о том, какие возможности для скачивания файлов есть в Selenide.

UPD
Ниже описаны только два способа скачивания - HTTPGET и PROXY. Позже появились третий способ FOLDER и четвёртый способ CDP. Возможно, вам нужен как раз один из них, если у вашей ссылки нет атрибута href, и прокси у вас не заводится.

Как я могу скачать файл в моём тесте?

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

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

profile.setPreference("browser.download.dir", downloadPath);
profile.setPreference("browser.download.folderList", 2);
profile.setPreference("browser.download.manager.showWhenStarting", false);
profile.setPreference("browser.helperApps.alwaysAsk.force", false);
profile.setPreference("browser.helperApps.neverAsk.saveToDisk", mimeTypes);
profile.setPreference("browser.download.manager.focusWhenStarting",false);
profile.setPreference("browser.download.manager.useWindow", false);
profile.setPreference("browser.download.manager.showAlertOnComplete", false);
profile.setPreference("pdfjs.disabled", true);

А в Selenide

Проблема решается гораздо проще - методом $.download().

Чтобы скачать файл, в Selenide достаточно просто вызвать метод:

File report = element.download();

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

Selenide сохранит скачанный файл в папку build/reports/tests. Это та же папка, где Gradle генерирует результаты прогона тестов, так что их как раз удобно видеть вместе.

Конечно, поменять эту папку тоже можно:

Configuration.downloadsFolder = <desired location for downloaded files>;

НО:

Таким образом можно скачивать файлы только со ссылкой с атрибутом “href”.

Но что, если у меня ссылки с атрибутом “href”? Так бывает, например, когда файл скачивается в результате сабмита формы. В этом случае можно скачивать файлы с помощью встроенного в селенид прокси-сервера.

Для начала нам нужно включить его (т.к. он по умолчанию выключен):

Configuration.proxyEnabled = true;
Configuration.fileDownload = PROXY;

После этого мы снова можем вызывать метод $.download(), но теперь он стал более могущественным и не требует наличия атрибута “href”:

File report = element.download();

Хозяйке на заметку:

Не забудьте увеличить таймаут, если собираетесь скачивать файл большого размера.

Файл будет скачан в папку по умолчанию (что-то типа C:\downloads and settings\downloads).
Таким образом, скачанный файл окажется в двух местах: c:\downloads... и build/reports/tests.

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

FileUtils.deleteDirectory(new File(<папка, подлежащая удалению>));  

Узнать подробнее про механизмы скачивания файлов можно тут.

Maciej Grymuza (figrym@gmail.com)

Почему статики запретили, а потом разрешили?

2019-12-09T00:00:00+00:00

Привет!

9 день рождественского календаря Selenide.
Расскажу о том, что сильнее всего волнует общественность.

Почему статики запретили в 5.0.0, а потом снова разрешили?

Короткий ответ: запретили случайно. Но правильно сделали.

А теперь подробнее.

Коротко о хранении вебдрайверов в селениде

Селенид изначально хранил вебдрайверы в ThreadLocal.
Это позволяет запускать тесты параллельно: в разных потоках - разные вебдрайверы. Код выглядит примерно так:

class WebDriverRunner {
  private static final ThreadLocal<WebDriver> webdriver = new ThreadLocal<>();
  private static final ThreadLocal<SelenideProxyServer> proxy = new ThreadLocal<>();
}

Скажем, метод $("a").click() работает примерно так:

  WebDriverRunner.webdriver.get().findElement("a").click();

Коротко про `SelenideDriver`

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

Это мы и собирались решить в Selenide 5.0.0. Мы сделали специальный класс SelenideDriver, позволяющий использовать два вебдрайвера в одном тесте:

SelenideDriver browser1 = new SelenideDriver();
SelenideDriver browser2 = new SelenideDriver();

browser1.open("https://google.com");
browser2.open("http://yandex.ru");

browser1.$(h1).shouldHave(text("Google"));
browser2.$(h1).shouldHave(text("Yandeks"));

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

И вот тут главный вопрос

А что делать со старыми добрыми статическими методами open(), $ и $$? Они должны откуда-то взять инстанс SelenideDriver и передать его дальше в кишки селенида. Откуда его взять?

Selenide 5.0.0: Статикам наносят удар

На тот момент этот вопрос решили так (как оказалось, это решение сильно повлияло на ход дел).
В класс WebDriverRunner добавили третий ThreadLocal:

  private static final ThreadLocal<SelenideDriver> selenideDriver = new ThreadLocal<>();

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

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

public class MyPageObject {
  public static SelenideElement fname = $("#fname");
  public static SelenideElement lname = $("#lname");
}

Да ещё и переоткрывали браузер между тестами.

Важный нюанс:

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

Конечно, это происходило из-за плохого кода тестов, но мы же создали селенид, чтобы помогать людям, верно?
Поэтому с версии 5.0.0 селенид стал чётко говорить: “Браузера нет, работать не могу. Вызови сначала метод open(), тогда поговорим.”

И что же свалилось?

Совпадение этих двух факторов привело к следующей проблеме:

Человек создаёт статическую переменную static SelenideElement fname = $("#fname").
Этот fname запоминает, с каким инстансом SelenideDriver он был создан.
Человек в конце теста закрывает браузер
В следующем тесте человек открывает новый браузер и снова обращается к статическому полю fname.
А fname обращается к своему SelenideDriver, с которым он был изначально создан.
И кидает ошибку, потому что тот браузер уже закрылся.

Больше года - с сентября 2018 до октября 2019 - я пытался объяснить всем, что статические переменные - это зло, не надо их использовать.
Сделал даже специально доклад “Антистатик”.

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

Selenide 5.4.0: Статики победили

Как в итоге решили эту проблему?

Довольно просто. Мы заменили ThreadLocal<SelenideDriver> на статическую переменную (да, вы не ослышались :))

private static final SelenideDriver = new ThreadLocalSelenideDriver();

Теперь наш “статический” SelenideDriver - один на всех. Он никогда не закрывается. Все статические поля, созданные с ним, будут жить вечно. Но он и не хранит в себе поля WebDriver и SelenideProxyServer. Он каждый берёт их из тредлокалов WebDriverRunner.

P.S.

Поэтому в версии 5.4.0 пропал метод WebDriverRunner.getSelenideDriver().

Я очень удивился, что многие люди уже успели его использовать. Люди, я вас не понимаю! Как вы умудряетесь всё так неправильно использовать?
Ок, я не подумав, сделал его публичным. Моя ошибка. Но он не упомянут ни в каких пресс-релизах, ни в какой документации. Как могла кому-то прийти в голову идея его использовать? Как эта магия вообще происходит?

Что теперь?

Мы снова вернули возможность объявлять SelenideElement в статических полях.
Но пожалуйста, не злоупотребляйте этим.
Я всё ещё это не одобряю. :)

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

ru.selenide.org

Как протестировать защиту от CSRF атаки

2019-12-07T00:00:00+00:00

Привет!

Сегодня 7 день рождественского календаря Selenide.
И сегодня мы поговорим о тестировании безопасности.

Что такое CSRF?

Одна из самых распространённых атак - это CSRF (Cross-Site Request Forgery), или подделка межсайтовых запросов. Подробно о ней я рассказывал в видосике WTF Security, а сейчас для нас важно то, что защиту от этой атаки легко протестировать вашими обычными автотестами.

Для того, чтобы веб-приложение было защищено от CSRF-атак, с каждым его POST-запросом должен посылаться один хитрый параметр. Он обычно называется authenticityToken (хотя и не обязательно). Когда вы заходите в одной вкладке, скажем, в свой интернет-банк, а в другой вкладке на сайт с котиками, зловредный код на этом сайте может послать POST-запрос вашему банку для совершения платежа на счёт хакера. Хакер может послать счёт и сумму, а также все cookies из вашей вкладки, но он не сможет послать authenticityToken (потому, что он уникальный для каждой сессии и не хранится в cookies).

А типичная ошибка такая: веб-приложение либо не посылает authenticityToken на сервер с каким-то POST-запросом, либо на сервере не проверяет пришедший токен.

Короче, как проверить защищённость?

У вас уже есть куча автотестов, покрывающих весь критичный функционал вашего веб-приложения.
Мы убьём двух зайцев разом: во время запуска этих тестов мы будем перехватывать каждый POST-запрос и посылать точно такой же, но с изменённым authenticityToken. И будем проверять, что сервер вернул ошибку. Обычно это ошибка 403 Forbidden.

Звучит сложно. Как это закодить?

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

Шаг 1. Включаем селенидовский прокси-сервер

Configuration.proxyEnabled = true;

(это нужно сделать ДО открытия браузера)

Шаг 2. Добавляем листенер для прокси-сервера

abstract class BaseTest {
  private AuthenticityTokenChecker authenticityTokenChecker = new AuthenticityTokenChecker();

  // и где-то сразу после open("http://..."):
  getSelenideProxy().getProxy().addRequestFilter(authenticityTokenChecker);
}

На данный момент это можно сделать только ПОСЛЕ открытия браузера, что иногда не очень удобно.
Я надеюсь, в следующей версии селенида мы сможем сделать так, чтобы листенеры для прокси-сервера можно было добавлять в любой момент.

Шаг 3. Реализуем AuthenticityTokenChecker

import com.codeborne.selenide.Configuration;
import io.netty.handler.codec.http.*;
import net.lightbody.bmp.filters.*;
import net.lightbody.bmp.util.*;

public class AuthenticityTokenChecker implements RequestFilter {
  private final HttpClient httpClient = HttpClient.newBuilder().build();

  private final List<String> unprotectedUrls = new ArrayList<>(1);

  public void reset() {
    unprotectedUrls.clear();
  }

  public List<String> getUnprotectedUrls() {
    return unprotectedUrls;
  }

  @Override
  public HttpResponse filterRequest(HttpRequest httpRequest, HttpMessageContents contents, HttpMessageInfo httpMessageInfo) {
    if (httpRequest.getMethod() != HttpMethod.POST) return null;                   // игнорируем не-POST запросы
    if (!httpRequest.getUri().startsWith(Configuration.baseUrl)) return null;      // игнорируем запросы хрома к google.com и подобным ресурсами
    if (Этому урлу разрешено и без токена) return null;                            // некоторым post-запросам не требуется защита

    String body = contents.getTextContents();
    if (!body.contains("authenticityToken=")) {
      unprotectedUrls.add("No 'authenticityToken=' found for " + httpRequest.getUri() + " in " + body);
      return null;
    }

    sendHackedPostRequest(httpRequest, contents);
    return null;
  }
}

Обратите внимание: return null; значит “не изменяй запрос”. То есть браузер пошлёт изначальный запрос на сервер без изменений, и нормальное течение вашего теста не будет нарушено.

Шаг 4. Посылаем хакнутый POST-запрос

  private void sendHackedPostRequest(HttpRequest httpRequest, HttpMessageContents contents) throws IOException, InterruptedException {
    // Над этой строчкой придётся поработать. 
    // Формат запроса (и даже имя параметра "authenticityToken") может зависеть от вашего приложения.
    // Обратите внимание, что параметров "authenticityToken" может быть несколько (сразу кидайте ошибку, если они разные).
    // Если в POST-запросе сабмитится форма, да ещё и с файлами, параметр "authenticityToken" придётся выцепить немножко по-другому. 
    String hackedBody = contents.getTextContents()
        .replace("authenticityToken=1234567890").на("authenticityToken=hack-me-if-you-can");

    java.net.http.HttpRequest.Builder builder = java.net.http.HttpRequest.newBuilder()
      .uri(URI.create(httpRequest.getUri()))
      .timeout(Duration.ofSeconds(1));

    for (Map.Entry<String, String> header : httpRequest.headers()) {
      if (!restrictedHeaders.contains(header.getKey().toLowerCase())) {
        builder.header(header.getKey(), header.getValue());
      }
    }

    java.net.http.HttpRequest request = builder
      .POST(java.net.http.HttpRequest.BodyPublishers.ofString(hackedBody))
      .build();

    log.info("Sending hacked request to {}", httpRequest.getUri());

    java.net.http.HttpResponse<String> httpResponse = httpClient.send(request, java.net.http.HttpResponse.BodyHandlers.ofString());

    if (httpResponse.statusCode() == 403) {
      log.info("Hacked request was rejected: {} {}", httpResponse.statusCode(), httpRequest.getUri());
    }
    else {
      log.error("HACK SUCCEEDED {} {}", httpResponse.statusCode(), httpRequest.getUri());
      unprotectedUrls.add("Detected URL without authenticity token check: " + httpRequest.getUri());
    }
  }

  private static final Set<String> restrictedHeaders = Set.of("connection", "content-length",
    "date", "expect", "from", "host", "upgrade", "via", "warning");

Конкретно эта реализация использует HttpClient из Java 11, но если вы из тех бедолаг, что до сих пор сидят на Java 8, вы можете заменить его на OkHttp, Apache Http Client или что-то подобное.

Шаг 5. Валим тест, если нашлись незащищённые запросы

abstract class BaseTest {
  @Before void resetChecker() {
    authenticityTokenChecker.reset();
  }

  @After
  public void verifyThatAllPostRequestsAreProtectedWithAuthenticityToken() {
    if (!authenticityTokenChecker.getUnprotectedUrls().isEmpty()) {
      fail(String.valueOf(authenticityTokenChecker.getUnprotectedUrls()));
    }
  }
}

Что теперь?

Мы убили двух зайцев и научились автоматически проверять защиту от CSRF-атак при запуске наших обычных автотестов.
Это не фантазия, мы реально так сделали на одном проекте и нашли две серьёзных уязвимости в настоящем интернет-банке.

Хорошо, но этого мало. На свете ещё куча атак.

Пересмотрите WTF Security, почитывайте OWASP 10 и мыслите креативно, а как ещё можно убить третьего и четвёртого зайца вашими автотестами.

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

ru.selenide.org

Как визуализировать клик

2019-12-06T00:00:00+00:00

Привет!

На дворе 6 декабря, мы продолжаем рождественский календарь Selenide.
И сегодня я покажу один простой способ поймать некоторые нестабильные тесты.

Что не так с кликами?

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

Почему селенид это уже не решил?

Глобальное решение могло бы быть такое: метод $.click(), перед тем, как кликнуть, сначала ждёт окончания любых движений и анимаций. Но пока в селениде такого нет: я боюсь, что сделать абсолютно универсальную “ожидалку” на все случаи жизни просто невозможно. Проекты разные, UI разный, фреймворки разные, анимации разные. Если у вас есть идеи, как это можно было бы реализовать - обращайтесь, запилим.

А пока нам остаётся делать какие-то свои “ожидалки” в каждом конкретном проекте.

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

Как визулизировать клик?

Можно добавить такой вот JS код в своё приложение. Он слушает любые клики на странице, и подсвечивает зелёной рамкой тот элемент, которые реально был кликнут. Это поможет вам на скриншоте упавшего теста понять, что клик попал не в тот элемент, который вам был нужен.

#{if test}
    <script>
      function onClick(event) {
        var e = event || window.event;
        var target = e.target || e.srcElement;
        target.style['box-sizing'] = 'border-box';
        target.style['border'] = '2px solid green';
      }
    
      document.addEventListener('click', onClick);
    </script>
#{/if}

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

Здесь можно посмотреть один из примеров реализации: Highlighter.

Что теперь?

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

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

ru.selenide.org

Как быстро проверить размер?

2019-12-04T00:00:00+00:00

Драсьте!

На дворе 4 декабря, перед вами открыт рождественский календарь Selenide, и в сегодняшнем посте я покажу один простой трюк, как сделать некоторые проверки быстрее.

Как быстро проверить размер коллекции?

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

@Test {
 $$("#books .book").shouldHave(size(3));
}

А если страница реализована так, что в HTML книг больше, а ненужные книги просто прячутся, то можно отфильтровать коллекцию перед проверкой:

@Test {
 $$("#books .book").filter(visible).shouldHave(size(3));
}

Проблема

Если таких книг на странице много (скажем, несколько десятков и больше), то такая фильтрация может быть медленной (скажем, от нескольких секунд и выше). Причина в том, что метод filter(visible) должен вызвать метод WebElement.isDisplayed() в цикле для каждого элемента коллекции по отдельности. А каждый вызов - это отдельное обращение к вебдрайверу, отдельный http запрос и т.д. В сумме накапливается.

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

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

Первая попытка

Как можно ускорить эту проверку? Напрашивается первое решение: фильтровать видимые элементы на уровне селектора:

@Test {
 $$("#books .book:visible").shouldHave(size(3));
}

Но так не работает.

Проблема в том, что CSS-селектора :visible не существует. Такую штуку умеет делать только JQuery.

Вторая попытка

Что же нас спасёт?

Вера Брежнева ошибалась: мир спасёт не красота, мир спасёт уродство. И имя ему - JavaScript.

Вы можете создать вспомогательный метод, который с помощью JavaScript и JQuery вернёт количество элементов:

private int sizeOf(String cssSelector) {
  Number count = executeJavaScript("return $(arguments[0]).length", cssSelector);
  return count.intValue();
}

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

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

@Test {
  assertEquals(1, sizeOf("#books .book:visible"));
}

Что теперь?

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

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

ru.selenide.org

setWebDriver или WebDriverProvider?

2019-12-03T00:00:00+00:00

Добрый вечер!

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

Что выбрать, `setWebDriver()` или `WebDriverProvider`?

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

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

Итак,

Вариант 1:

  Configuration.browser = MyWebdriverProvider.class.getName();

Этот вариант предпочтительнее в большинстве случаев. Он хорош тем, что ваш класс MyWebdriverProvider отвечает только за то, КАК открыть браузер (какие ключики ему передать, где найти бинарник, вот это всё). Но не отвечает за то, КОГДА открыть и закрыть браузер. Об этом заботится селенид.

Вариант 2:

@Before
public void setUp() {
  var yandexBrowser = new YandexDriver(...);
  WebDriverRunner.setWebDriver(yandexBrowser);
}

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

Отсюда назревает вопрос:

А зачем он вообще нужен?

Честно говоря, я сам долгое время не отдавал себе в этом отчёт, и лишь недавно назрело понимание. :)

Изначально метод setWebDriver() был добавлен для того, чтобы людям было легко перевести на селенид существующие проекты (не переписывая весь проект).

Представьте, что в компании X уже есть стотыщ автотестов на селениуме (или HtmlElements, Thucydides, Serenity или чём-то ещё). И они хотят новые тесты писать на селениде, а старые не трогать. Работают и работают.

И у них где-то в тестах уже есть код, которые открывает и закрывает браузер. И хотелось бы как-то сказать селениду, чтобы он тоже этот браузер использовал. Вот для этого и подходит метод setWebDriver(). Он позволяет запускать и старый, и новый код вперемежку, так чтобы они работали с одним и тем же браузером и не мешали друг дружке.

То есть применение у метода setWebDriver(), как вы видите, довольно узкое. Я вообще не уверен, использовали ли его вообще хоть когда-нибудь в таком ключе.

Что теперь?

А если вы пишите новый проект, используйте WebDriverProvider. SRP.

UPD

Позже в Selenide 5.16.1 появилась более новая возможность - DriverFactory. Теперь это рекомендованный способ создавать кастомный вебдрайвер.

По сути она очень похожа на WebDriverProvider, но даёт больше контроля над происходящим. Вам нужно

либо реализовать интерфейс DriverFactory,
либо создать подкласс ChromeDriverFactory, FirefoxDriverFactory или другого похожего класса (которые есть в составе Selenide и реализуют интерфейс DriverFactory) и переопределить лишь нужные методы. Все методы в них специально сделаны маленькие и объявлены как protected.

Примеры есть в тестах самого селенида.

См. также этот пост от Boris Bay.

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

ru.selenide.org

Как надругаться над Селенидом

2019-12-02T00:00:00+00:00

Всем привет!

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

Как надругаться над Селенидом

(и почему это у многих вызывает трудности)

Я часто получаю жалобу, что у людей не ловится ошибка вот в таком коде:

try {
  $(".banner").shouldBe(visible);
  $(".banner .close").click();
}
catch (Exception e) {
  // System.out.println("Элемент не найден - значит, баннер в этот раз не появился");
}

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

Почему это плохой тест?

Потому, что он медленный.

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

Это ужасно. Вы профессионалы или кто? Ваша цель - сделать тесты быстрыми и надёжными. Иначе чем вы отличаетесь от обезьяны?

Почему это очень плохой тест?

Потому, что он нестабильный.

Иногда баннер будет появляться как раз на истёке 4 секунд. Тест решит, что баннера нет, и пойдёт дальше, а тут оп! - и выскочит баннер. И вы получаете “моргающий” тест.

Почему это очень-очень плохой тест?

Потому, что он не тестирует сам баннер.

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

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

А ваши тесты зелёные.

Что же делать?

Очевидно, что у вас должно быть как минимум два теста:

Случай, когда баннер выскакивает, и
Случай, когда баннер не выскакивает.

Значит, у вас должна быть возможность как-то управлять показом баннера. Либо через “ручку” (api) тестируемого приложения, либо через какую-то админку, либо запуском SQL в базе. Как угодно. Если такой ручки нет, надо пойти договориться с разработчиками.

Только не надо мне говорить, что договориться не получится. Вы профессионалы или кто?

Если не получится, то стирайте весь этот тест. Не получилось так не получилось.

Подробнее про ручки и управление тестовой средой см. в докладе Arrange, mazafaka!

И наконец, на десерт:

Почему ошибка не ловится?

Вы уже догадались, почему ошибка не ловится?

Всё дело в иерархии исключений в Java. Базовый класс не Exception, а Throwable.

Throwable
- Exception
  - RuntimeException
    - WebDriverException
- Error
  - AssertionError
    - UIAssertionError
      - ElementShould

Именно поэтому, когда вы ловите catch (Exception e), мимо вас пролетают все подклассы Error, в том числе все селенидовские ошибки.

“Ну отлично, буду ловить catch (Error e)” - решите вы. НЕТ! Прошу вас, НЕТ!

Читаем javadoc к классу java.lang.Error:

An Error is a subclass of Throwable that indicates serious problems that a reasonable application should not try to catch. Most such errors are abnormal conditions.

Что теперь?

Я надеюсь, вы перестанете ловить ошибки в тестах. Тесты для того и созданы, чтобы сообщать об ошибках, а не ловить их.

Надеюсь, вы посмотрите Arrange, mazafaka! и возьмёте управление тестовой средой под свой контроль.

И решите для себя, тварь вы дрожащая, или право имеете?

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

ru.selenide.org

Главный Алгоритм

2019-12-01T00:00:00+00:00

Всем привет!

В западном мире начался период “Адвент”, или ожидание Рождества.

Дети распаковывают свои “рождественские календари”, в которых открывают каждый день по окошечку (и находят под ним шоколадку). В Java мире, например, ведут Java Advent Calendar, в котором разные авторы каждый день публикуют по статье. Я тоже в нём участвовал пару раз (2017 и 2018).

Я тоже решил не отставать и замутить Selenide Advent Calendar. Каждый день по статье. С 1 по 25 декабря. Начну я, а вы можете присоединиться - сообщите о себе любым способом.

Сегодняшняя тема будет такая:

Самый Главный Алгоритм

Главная фишка селенида, как многие считают - это автоматические ожидания. Вам не нужно писать лишний код типа new WebDriverWait(driver, 30).until(ExpectedConditions.visibilityOfElementLocated(By.xpath("//div[contains(text(),'COMPOSE')]"))), чтобы дождаться наступления какого-то события. Вам не нужно тратить время и силы, чтобы вообще думать о том, а где нужны ожидания. Вам не нужно раз за разом спотыкаться о моргнувший тест и думать, куда бы ещё добавить ожидание.

В селениде всё проще: любая строчка типа $(byText("COMPOSE")).shouldBe(visible) автоматически ждёт, если надо.

А не замедлит ли это тест?

Нет.

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

Естественно, эти 4с и 100 мс настраиваются. Вы можете задать любой таймаут под ваш проект.

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

Вот мы и переходим к Самому Главному Алгоритму. На самом деле он очень прост.

Вот как работает, например, метод $(".btn").shouldBe(visible):

void shouldBeVisible() {
  do {
    try {
      assert webdriver.findElement().isDisplayed() == true;
      return ok;
    }
    catch (Exception e) {
      sleep(100 мс)
    }
  } while (прошло меньше N секунд);
  throw new ElementShouldBeVisible("Ожидали: то-то, на самом деле: то-то");  // тут ещё сделать скриншот.
}

В общем-то всё просто.

Этот же код в реальности выглядит чуть сложнее. А всё потому, что он “универсальный” - не только для shouldBe(visible), но и для других операций и условий.

Как известно,

дьявол кроется в деталях

В приведённом выше коде есть масса вопросов:

Какие именно ошибки ловить?
- Exception, Error, Throwable, AssertionError, WebDriverException?
В случае каких ошибок надо вылететь сразу, не продолжая ожидание?
- например, если XPath невалидный, то он и через 4 секунды будет невалидный.
Результат хороший или плохой?
- например, если элемент не найден - это может быть ок для условия $.shouldNot(exist).
В какой момент делать скриншот?
Можно ли всё это кастомизировать?
- Например, при использовании Аллюра, возможно, не стоит снимать скриншот, ведь Аллюр сам снимет скриншот.
- Или наоборот, стоит снять скриншот и как-то передать его Аллюру?
- (сейчас и Селенид, и Аллюр делают каждый по скриншоту, так что они дублируются)
Что делать, если мы дошли до последней строки, а вот в ней-то как раз прилетел зло#учий StaleElementException?

Ответы на эти вопросы менялись с течением времени. И наверное, будут ещё меняться. Но суть остаётся.

Что теперь?

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

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

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

ru.selenide.org

Вышла Selenide 5.5.1

2019-11-29T00:00:00+00:00

Всем привет!

Соскучились?

Чтобы вы не расслаблялись, мы выпустили Selenide 5.5.1 с парочкой новых фич.

Эмуляция мобильного браузера
Пометили метод Selenide.close() как устаревший
Новости

Добавили эмуляцию мобильного браузера

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

Как будто этот хром открыли бы на мобильном телефоне или планшете.

(Например, сайт selenide.org открывается на мобилке очень криво. :( Мы работаем над этим.)

Теперь это легко сделать, добавив такую вот System property перед запуском вебдрайвера:

java -Dchromeoptions.mobileEmulation="deviceName=Nexus 5"

или прямо в коде:

System.setProperty("chromeoptions.mobileEmulation", "deviceName=Nexus 5");

NB! Речь идёт только об одной опции - имени устройства. Этого достаточно в большинстве случаев. Если вам нужна более тонкая настройка мобильного браузера, го реализовывать WebDriverProvider с аргументами и опциями.

См. 1008 и PR 1011.

Пометили метод `Selenide.close()` как устаревший

В селениде издревле был метод Selenide.close(). Но он вводил в заблуждение, т.к. он закрывал весь браузер, а не только активную вкладку. В то же время в Selenium есть метод close(), который закрывает только текущую вкладку (и только если она была единственной - весь браузер). А для закрытия всего браузера в Selenium есть метод quit().

Я, конечно, виноват, что сделал когда-то метод close(), не почитав документацию к Selenium. Я был молод и не верил в javadoc. Но и селениумовские названия close vs quit тоже, честно говоря, не очень удачные. Поди запомни, кто из них что закрывает.

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

Selenide.closeWindow() - закрывает текущее окно (или вкладку, что для селениума одно и то же)
Selenide.closeWebDriver() - закрывает весь браузер

Запоминать больше ничего не придётся.

А метод Selenide.close() мы пока пометили как @Deprecated. Удалим в Selenide 6.0.0

См. 1016 и PR 1017.

Новости

Огонь-огонь! Новый плагин IDEA для Selenide/Selenium: QA Lithium. Спасибо Yuriy Artamonov!
Ещё один фреймворк на базе Selenide: Masquerade - CUBA Platform UI Testing Library
Статья про Selenide и Selenoid
И ещё про Selenide и Selenoid

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

ru.selenide.org

Вышла Selenide 5.5.0

2019-10-31T00:00:00+00:00

Всем привет!

А как вы празднуете Хэллоуин?

Мы вот выпустили Selenide 5.5.0 с несколькими обратно несовместимым изменениями.

СТРАШНО?

Перешли с JUL на SLF4J

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

До сих пор Селенид писал свои логи через стандартный Java механизм java.util.logging (т.н. JUL). Всем известно, что у него есть недостатки, и поэтому в Java мире давно появилась целая куча библиотек, в которых сложно разобраться: Log4J, Slf4j, Logback, JCL.

В общем, теперь будет так.

Slf4J - это “фасад”, что-то типа “интерфейса”. Селенид будет писать логи через него.
А Log4j, Logback, JCL - это реализации этого “интерфейса”. Наверное, есть и другие.

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

Чтобы подключить одну из реализаций Slf4J, вы должны добавить в проект одну из зависимостей:

slf4j-log4j12-*.jar
logback-classic-*.jar
slf4j-simple-*.jar
slf4j-jdk14-*.jar
slf4j-jcl-*.jar
slf4j-nop-*.jar (ТОЛЬКО НЕ ЭТО! Это самый плохой вариант. Он будет игнорировать логи.)

NB! Подчёркиваю, что скорее всего такая зависимость у вас уже есть, и поэтому делать ничего не надо. Оно само заработает.

Если же зависимости всё-таки нет, вы увидите такое сообщение при запуске тестов (и не увидите логов селенида):

SLF4J: Failed to load class "org.slf4j.impl.StaticLoggerBinder".
SLF4J: Defaulting to no-operation (NOP) logger implementation
SLF4J: See http://www.slf4j.org/codes.html#StaticLoggerBinder for further details.

Если вы его увидите, самое простое решение - это добавить такую строчку в ваш build.gradle:

testRuntimeOnly 'org.slf4j:slf4j-simple:1.7.28'

или в pom.xml:

<dependency>
    <groupId>org.slf4j</groupId>
    <artifactId>slf4j-simple</artifactId>
    <version>1.7.28</version>
    <scope>test</scope>
</dependency>

NB! Если не разобрались с Slf4j - не паникуйте, логи селенида не очень-то важны. Ошибки при падении тестов никуда не денутся. Речь идёт только про служебные INFO и WARNING логи типа INFO Using browser binary: /var/lib/opera.exe.

См. 923.

Спасибо Gleb Schukin за PR 926.

Удалили зависимости HtmlUnit и PhantomJS

Не переживайте, тесты должны по-прежнему работать на HtmlUnit и PhantomJS, просто селенид больше не тянет эти зависимости автоматически (ведь большинство людей давно перешли на headless chrome и headless firefox).

Если вы упорно хотите использовать HtmlUnit или PhantomJS, вам просто нужно будет добавить соответствующие зависимости в проект.

Спасибо Aliaksandr Rasolka за PR 1003 и PR 998.

Удалили встроенную поддержку браузера Safari

Но не волнуйтесь, вы всё ещё можете использовать Safari! См. инструкцию

Сделали метод `$.execute(command)` более универсальным

Раньше метод $.execute умел работать только с Command<SelenideElement>, а теперь - с любыми командами.

См. Issue 1000 и PR 1001.

Починили настройку `holdBrowserOpen`

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

См. 999 и PR 1005.

Снимаем скриншот в случае ошибки `DialogTextMismatch`

Как вы знаете, в селениде есть функция для проверки текста диалогового окна (alert или confirm):

confirm("Are you sure?");

Но при падении этой проверке селенид забывал сделать скриншот. Теперь делает.

См. 907. Спасибо Nick Holloway за PR 986.

Рефакторинг ScreenShotLaboratory

Хотя это всего лишь рефакторинг, т.е. на вас он не повлияет, я не могу не отметить инициативу SeleniumTestAB, который решил улучшить код и запилил PR 1004 и PR 1006.

Новости

Статья на хабре: Автоматизация тестирования с использованием Selenide через Selenoid в Docker контейнере
Доклад про Selenide на конференции EclipseCon 2019: A complete Selenium Techstack
Мой доклад для Cyprus Quality Conference Тройничок: Selenide для Web, Android и iOS”. Пока только слайды.

И главное

И главное: 25 октября Селениду ИСПОЛНИЛОСЬ 8 ЛЕТ!!!

25.10.2011 был сделан первый коммит в репозиторий селенида. После 8 лет мы имеем:

89 тыщ скачиваний с 14 тыщ уникальных айпишников (в месяц)
1 тыща звёзд на гитхабе
55 контрибьютеров

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

Это только начало!

Статистика скачиваний Selenide за октябрь 2019:

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

ru.selenide.org

Вышла Selenide 5.4.1

2019-10-16T00:00:00+00:00

Всем привет!

Нет ничего унылее октября. Давайте же скрашивать его хорошими новостями!

Сегодня мы выпустили Selenide 5.4.0 с парочкой существенных изменений, о которых многие из вас давно просили.

UPD В 5.4.0 была ошибка, так что обновляйтесь сразу на 5.4.1

UPD 2 В 5.4.1 тоже нашлась малюсенькая ошибочка: опция Configuration.holdBrowserOpen не работает. Исправим в следующей версии. Надеюсь, вы не используете её часто.

1. Исправили ошибку “IllegalStateException WebDriver has been closed”

Начиная с Selenide 5.0.0 (т.е. примерно год назад), многие пользователи стали жаловаться на ошибку IIlegalStateException WebDriver has been closed....

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

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

В конце концов, каждый имеет право набивать свои шишки.

Если вкратце, ошибка эта случается, когда SelenideElement переиспользуют с разными инстансами SelenideDriver. Обычно так бывает, когда SelenideElement объявляют как статическое поле (в пэдж обжекте или в тесте, неважно). И инициализируют его раньше, чем открывается браузер. Либо перезапускают браузер между тестами. Ещё это бывает, когда используют Cucumber, который пытается инициализировать степы и пэдж обжекты до открытия браузеров. Или зачем-то пихают в тесты Guice или Spring. В тесты, Карл!

Так вот, всё это переусложнение и в тестах не нужно. Статические поля - зло. Подробнее об этом я рассказывал в докладе Антистатик.

Но раз уж людям так впёрлось - ладно. Ловите Selenide 5.4.0

Теперь вот такой код будет работать:

public class SomeClass {
  private static SelenideElement body = $("body");

  public static void main(String[] args) {
    open("https://mail.ru");
    body.should(exist);

    Selenide.close();

    open("https://mail.ru");
    body.should(exist);   // А раньше отсюда летел "IllegalStateException WebDriver has been closed"
  }
}

Больше примеров и жалоб можно найти в issue 862, 902, 954, 922, 873.

Как мы позволили статикам победить, можно отследить в PR 989.

2. Теперь `SelenideDriver.close()` всегда закрывает браузер

Опять же, начиная с Selenide 5.0.0, люди стали жаловаться на то, что метод close() не закрывает браузер. Конечно, не всегда, а только в одном специфическом случае - когда пользователь сам же браузер и открыл.

SelenideDriver browser=new SelenideDriver(new FirefoxDriver());
browser.close(); // вот так браузер НЕ закрывался
browser.getWebDriver().close(); // а так закрывался

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

Как говорят в Сбертехе,

где браузер открывали - там его и закрывайте. :)

Но опять же, жалобы были. У людей вызывало непонимание, как так: метод close() есть, отрабатывает без ошибок - но не закрывает.

Теперь мы это тоже исправили. Метод close() закрывает браузер.

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

См. issue 896 и PR 989

3. Вернули короткие сообщения об ошибках

Как мы могли заметить, в Selenide 5.3.1 прилетела одна некритичная регрессия. Сообщения об ошибках стали слишком длинными:

com.codeborne.selenide.ex.ElementNotFound: Element not found {#customerDashboardButton}

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

Element not found {#customerDashboardButton}

P.S. У бедных пользователей maven-surefire-plugin 2.22.2 всё ещё будут длинные сообщения, подробности тут. Сочувствую.

См. PR 993

4. Добавили метод `using` для лёгкого переключения несколькими вебдрайверами

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

Но теперь набивать шишки таким образом стало чуть удобнее.

Если раньше приходилось постоянно дёргать метод setWebDriver() и не забывать, какой браузер активный в данный момент:

var browser1 = new FirefoxDriver();
var browser2 = new FirefoxDriver();

setWebDriver(browser1);
open("http://google.com");
$("h1").shouldHave(text("Released Selenide 5.4.0"));

setWebDriver(browser2);
open("http://yandex.ru");
$("h1").shouldHave(text("Вышла Selenide 5.4.0"));

то теперь можно завернуть блоки кода для разных браузеров в разные блоки using:

var browser1 = new FirefoxDriver();
var browser2 = new FirefoxDriver();

using(browser1, () -> {
  open("http://google.com");
  $("h1").shouldHave(text("Released Selenide 5.4.0"));
});

using(browser2, () -> {
  open("http://yandex.ru");
  $("h1").shouldHave(text("Вышла Selenide 5.4.0"));
});

См. PR 976 и примеры кода в CustomWebdriverTest.java.

5. Добавили защиту от одной типичной ошибки с xpath

Типичная ошибка:

$(".parent").find(By.xpath("/child")).shouldBe(visible);

Дело в том, что XPath, начинающийся на слэш (“/”), ищет элемент от корня проекта (а не от элемента .parent, как, очевидно, хотел автор этого кода).

Слишком многие наступали на эти грабли. Поэтому мы добавили защиту от этой типичной ошибки.

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

IllegalArgumentException: XPath starting from / searches from root

Исправить этот код можно по-разному (смотря что вам требуется):

$(".parent").find(By.xpath("./child")).shouldBe(visible);
$(".parent").find(By.xpath(".//child")).shouldBe(visible);
$(".parent").find(By.xpath("child")).shouldBe(visible);

См. PR 963 и PR 975

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

upgrade to webdrivermanager:3.7.1
exclude old Guava dependency coming from net.lightbody.bmp:browsermob-core:2.1.5

Внимание, в WDM обнаружена ошибка: когда вы хотите скачать chromedriver версии 77, он иногда может скачать “75.0.3770.90”. Да-да, потому, что эта версия содержит подстроку “77”. Смешно, да? :)

Новости

Новая утилита Jabel от Сергея Егорова:
теперь можно писать на Java13, а компилировать в Java8. А что, так можно было???
Сергей Егоров - Как сделать OSS проект успешным – devclub.eu, Таллинн, 24.09.2019
Близкая мне тема. Вот примерно всем этим я и занимаюсь с Селенидом.
Видосик про Selenide на немецком - со школы не смотрел видео на немецком с таким интересом :)
Англоязычный мир открывает для себя Selenide. Там же ссылка на подкаст про Selenide.
Martin Škarbala из Словакии добавил к своему замечательному видео про Selenide английские субтитры:
Selenide - stručné UI testy.
10 причин моей ненависти – devclub.eu, Таллинн, 24.09.2019
Отличный доклад “Атомарный рефакторинг” от Тагира Валеева! Жёстко рекомендую.
Ещё один доклад с JPoint: Миру нужны фулстеки

Конференции

Друзья, в унылый пасмурный октябрьский денёк очень советую пойти на конференцию Joker. Круче этой программы ничего не может быть!

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

ru.selenide.org

Вышла Selenide 5.3.1

2019-09-07T00:00:00+00:00

Всем привет!

На днях случилась сенсация.

Презентация нового айфона прошла незамеченной!

Потому, что мы выпустили Selenide 5.3.1. Тоже с улучшенными снимками :)

В этой версии мы исправили ровно одну проблему, зато какую!

Maven, где мои скриншоты?

Недавно мы обнаружили, что пользователи мавена и свежего maven-surefire-plugin:2.22.2 были лишены одной из самых важных фич селенида: имя скриншота не добавлялось к сообщению об ошибке при падении теста.

Вот это нежданчик!

Как вы вообще жили без этого, бедняги?

Может, поэтому вы так упарываетесь по BDD, Серенити и Аллюру?

Для сравнения

Вот как выглядит сообщение об ошибке при падении теста в Maven и последнем maven-surefire-plugin:2.22.2:

com.codeborne.selenide.ex.ListSizeMismatch: 
: expected: = 11, actual: 0, collection: .results
Elements: []
	at org.selenide.GoogleTest.openGoogle(GoogleTest.java:42)

Вы видите скриншот? И я не вижу. А он есть.

А вот как выглядит ошибка в Gradle, Ant, любой IDE и дефалтовом maven-surefire-plugin:2.12.4:

List size mismatch. Expected: = 11, actual: 0, collection: .results
Elements: []
Screenshot: file:/Users/andrei/projects/selenide-examples/sandbox-selenide-junit5/build/reports/tests/1567803355181.0.png
Page source: file:/Users/andrei/projects/selenide-examples/sandbox-selenide-junit5/build/reports/tests/1567803355181.0.html
Timeout: 4 s.
	at org.selenide.GoogleTest.openGoogle(GoogleTest.java:42)

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

Жизнь заиграла совсем другими красками, правда?

Расследование

Но почему так получилось?

В Java есть класс Throwable, от которого наследуются все ошибки.
В нём есть два метода: getMessage() и toString().
По умолчанию toString() = имя класса + getMessage()

Например, такой код:

    Throwable e = new IllegalArgumentException("низя");
    System.out.println(e.getMessage());
    System.out.println(e.toString());

выдаёт:

    низя
    java.lang.IllegalArgumentException: низя

Фокус в том, что изначально Selenide добавлял имя скриншота именно в методе UIAssertionError.toString(). И это прекрасно работало в Gradle, Ant, всех IDE. Да и в Maven тоже - в дефалтовом maven-surefire-plugin.

Что же обновилось в Maven?

В Maven вообще сидят весёлые ребята.

В Maven для тестов зачем-то два плагина, а не один.
Называются они почему-то “surefire”, а не какой-нибудь “test”, что было бы всем понятно.
И по умолчанию последний Maven 3.6.2 почему-то использует разные версии этих плагинов:
- maven-surefire-plugin:2.12.4 - выпущена 7 лет назад (например, не поддерживает Java 11)
- и внезапно
  maven-surefire-report-plugin:3.0.0-M3 - типа бета-версия, как бы ещё сырая

Но вот если прописать в своём pom.xml более новую версию плагина:

      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-surefire-plugin</artifactId>
        <version>2.22.2</version>
      </plugin>

то начинаются чудеса. Вместо e.toString() он теперь зачем-то использует имя класса + getMessage(). Вот поэтому скриншоты и не добавляются больше к отчёту.

Как исправили?

Теперь мы добавляем скриншот в методе e.getMessage(), а не e.toString(). Звучит просто, но нам пришлось перелопатить все классы ошибок в Selenide и исправить кучу тестов.

Возможно, что-то получилось неидеально, поэтому смело рапортуйте, если найдёте шероховатости!

Всю предысторию и изменения кода можно найти здесь:

Новости

Селенид шагает по планете!

Зацените, какое классное видео сделал Martin Škarbala из Словакии. Всего за 1.5 минуты он успел показать, чем хорош Selenide и как много кода можно будет выкинуть.
Дмитрий Тучс: JUnit 5 + DDT: Что такое осень?
Антон Архипов: Анализ и отладка приложений в IntelliJ IDEA

Конференции

Приходите на конференцию QA Fest в Киеве 20-21 сентября!

Говорят, это крупнейшая конференция по тестированию в Украине. 5 потоков!
Много крутых спикеров и спикерш.

У меня будет два доклада:

“Селенид для продвинутых”
(параллелизация, статика, листенеры, прокси, трюки с JavaScript, производительность)
“10 причин моей ненависти”
(TestNG, репорты, пэдж обжекты, try/catch, ифы в тестах, dependency injection, spring и OverKISS)

Будет подгорать!

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

ru.selenide.org

Вышла Selenide 5.3.0

2019-09-02T00:00:00+00:00

В Selenide 5.2.8, как в игру,
На холодном ветру
Поиграли с тобой,
Но пришёл сам собой
Selenide 5.3.0

#968 Запускаем кустарные команды

Эта фича придётся вам по вкусу.

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

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

    var turnCalendar = new Command<SelenideElement>() {...};
    var pickDate = new Command<SelenideElement>() {...};
    var lookAtPhoto = new Command<SelenideElement>() {...};

    $("hiddenFileInput").execute(turnCalendar).execute(pickDate("03.09")).execute(lookAtPhoto);

Спасибо Aleksandr Rasolka за pull request 968.

#970 Дополнили текст ошибки для `shouldHave(attribute("href", ..."))`

Люди с полей сообщали о странной проблеме: href вроде бы одинаковый, а тест падает:

Element should have attribute href="/files/hello_world.txt" {by text: Download me}
Element: '<a href="/files/hello_world.txt">Download me</a>'

Оказалось, что дело в одной хитрой особенности Selenium: метод WebElement.getAttribute("href") возвращает абсолютный URL, а не относительный.
Подробнее об этом Алексей Баранцев рассказывал на Гейзенбаге 2018.

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

Actual value: href="http://my-test-env.com:9999/files/hello_world.txt"

#469 Улучшили текст ошибки для OR условий

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

    
    $("h1").shouldBe(or("poetic", 
      text("Пролетел жёлтый лист по бульварам Москвы"), 
      text("Горят костры рябин")
    ));

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

Element should have text 'Пролетел жёлтый лист по бульварам Москвы' {h1}

Мы это дело подправили, теперь он рапортует все условия из OR:

Element should be poetic: text 'Пролетел жёлтый лист по бульварам Москвы' or text 'Горят костры рябин' {h1}
Element: '<h1>3 сентября</h1>'

См. Issue 469 и PR 962.

Обновились до webdrivermanager:3.6.2

Похоже, в основном исправления для Edge. Changelog тут.

Всё то и всё так!

Новости

Автор WebDriverManager Boni García запилил selenium-jupiter - обёртку для Selenide (+JUnit5 +Docker). Обёртку для обёртки, прикиньте!
Сравнение Selenide и FluentLenium: Часть 1, Часть 2
Чума! Сергей Егоров (коммитер TestContainers) сотворил волшебство: Jabel. Теперь вы можете писать на Java13 и компилировать код в байт-код Java8.

Конференции

У меня будет два доклада:

“Селенид для продвинутых”
(параллелизация, статика, листенеры, прокси, трюки с JavaScript, производительность)
“10 причин моей ненависти”
(TestNG, репорты, пэдж обжекты, try/catch, ифы в тестах, dependency injection, spring и OverKISS)

Будет подгорать!

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

ru.selenide.org

Вышла Selenide 5.2.7

2019-08-01T00:00:00+00:00

Всем летний привет!

Мы выпустили несколько минорных обновлений Selenide: 5.2.5-5.2.7. Давайте расскажу, зачем понадобилось несколько.

Подправили сообщения об ошибках при запуске Selenide+Appium

Appium - это вебдрайвер для мобилок (AndroidDriver, IOSDriver). Казалось бы, хорошая идея - использовать для тестирования мобилок знакомый протокол Selenium WebDriver. Только вот многие вещи, казавшиеся логичными и стандартными в вебе, в мобилках работают по-другому или вовсе не работают.

Appium для Selenium - это как геометрия Лобачевского для геометрии евклидовой: всё круглое и через жопу.

Из-за этого, в частности, Селенид выдавал некорректные сообщения об ошибках при падении тестов. Потому, что при попытке сформировать сообщение об ошибке Селенид вызывает некоторые “стандартные” методы, которые до аппиума всегда работали во всех браузерах: $.getTagName(), $.isDisplayed(), executeJavascript(), но которые падают в Appium (или в Android, или в iOS, или везде).

В общем, для исправления этой неприятности пришлось нам добавить несколько catch (NoSuchElementException | UnsupportedOperationException | UnsupportedCommandException | WebDriverException), по сути нужных только в случае аппиума. В общем-то версии 5.2.6 и 5.2.7 как раз и понадобились для того, чтобы добавить очередной catch для очередного странного кейса.

Ну ничего, зато теперь Селенид с мобилками работает стабильнее.

См. issue 496 - Fix $.toString() in Appium

NB! Примеры тестов Selenide для мобилок можно найти на гитхабе.

Добавили метод `open()` без параметров

Этот метод просто открывает браузер. Пустой, blank. Без ссылки, blank.

Это тоже нужно для мобилок - ведь Селенид 5.+ требует, чтобы браузер был открыт перед тем, как совершать какие-либо операции с элементами. А в аппиум традиционный метод open(URL) не работает - там ведь нет никакого URL.

Глупая ситуация, но выход мы нашли элегантный, правда? :)

(Люди ведь и раньше просили возможность открыть пустой браузер. Как это ни странно.)

Спасибо yaroslav-orel за PR 956.

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

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

$("#login").shouldBe(disabled);
$("#login").shouldBe(disabled.because("Этот неудачник ввёл неверный пароль 3 раза"));

Теперь такой же метод есть и для коллекций:

$$(".cv").shouldHave(size(3));
$$(".cv").shouldHave(size(3).because("У Пети два CV, а у Ани одно."));

Спасибо Roman Kliuha за PR 904

Исправили казус с open внутри open

А это прямо анекдотичный случай. Вызываешь ты такой метод open(url), а он тебе кидает ошибку:

IllegalStateException: No webdriver is bound to current thread: 19. You need to call open(url) first.

Типа, “вызвать open нельзя, потому что сначала нужно вызвать open”. Вызывать open экономически невыгодно.

Дело оказалось в связке Selenide+Allure.

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

См. фикс в

Selenide: issue 928 и PR 958
Allure: issue 379 и PR 380

Новости

Яков Крамаренко, в своём время активный продвигатель идей селенида, проснулся от зимней спячки и бесплатно опубликовал свои курсы по автоматизации. А также начал писать книгу про Selenide:

Откровение от Якова Искусство Автоматизации с Selenide
Курсы Якова Автоматизация с нуля (Java, Selenide, Widgets aka PageObjects)
Видео Антистатик - Андрей Солнцев в DevClub, Таллинн, 27.06.2019
Видео «Selenide 2019 — Quo vadis? Новинки и малоизвестные функции библиотеки» - Алексей Виноградов на ComaQA Spring 2019
Пост Простота кода - блог Selenide, 08.07.2019

Конференции

Я выступаю в Киеве 20-21 сентября на конференции QA Fest. Приезжайте, приходите! Говорят, Киев в сентябре прекрасен.

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

ru.selenide.org

Простота кода

2019-07-08T00:00:00+00:00

Давайте поговорим о простоте кода. Наверное, все согласны с тем, что простой код - хороший код. Только все понимают “простоту” по-разному.

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

Задача

Есть некий список типа “Gmail” с чекбоксами и заголовками. Требуется пэджобжект, который позволил бы найти по заголовку и кликнуть один или несколько чекбоксов.

Структура HTML

не важна, но схематично выглядит она так:

<div class="box">
  <div class="boxCheckbox">
    <input type="checkbox">...</input>  
  </div>
  <div class="boxLabel">
    Here is checkbox #1  
  </div>
</div>
<div class="box">
  ...
</div>
...

т.е. у нас есть несколько <div class="box">, внутри каждого пара <div class="boxCheckbox"> + <div class="boxLabel">.

Сложный код

Перед вами типичный код, который мне приходилось видеть примерно миллион раз.

Это олицетворение современной автоматизации тестирования (так мне иногда кажется).

import org.openqa.selenium.WebElement;
import org.openqa.selenium.support.FindBy;

import java.util.ArrayList;
import java.util.List;

public class SeleniumPageObject {

  // Search for element index in the list by title
  public static List<Integer> findListIndexesByTitle(List<WebElement> elementList, String SearchText) {
    List<Integer> ints = new ArrayList<>();
    for (int i = 0; i < elementList.size(); i++) {
      if (elementList.get(i).getText().contains(SearchText)) {
        ints.add(i);
      }
    }
    return ints;
  }

  // Buttons in the boxes
  @FindBy(xpath = "//div[@class='boxCheckbox']")
  private List<WebElement> selectCheckBoxesInBoxes;

  // Titles for boxes
  @FindBy(xpath = "//div[@class='boxLabel']")
  private List<WebElement> listOfTitlesInBoxes;

  // Select Box by title
  public void selectBoxByTitle(String searchTitle) {
    int index = findListIndexesByTitle(listOfTitlesInBoxes, searchTitle).get(0);
    selectBoxByIndex(index);
  }

  // Select Box by index
  private void selectBoxByIndex(int elPosition) {
    selectCheckBoxesInBoxes.get(elPosition).click();
  }

  // Select All Boxes by title
  public void selectAllBoxesByTitle(String searchTitle) {
    List<Integer> ints = findListIndexesByTitle(listOfTitlesInBoxes, searchTitle);
    for (int i = 0; i < ints.size(); i++) {
      selectBoxByIndex(ints.get(i));
    }
  }
}

Не буду повторяться, почему комментарии в коде не нужны, что @FindBy обычно ничего не упрощает и т.д. Просто сравните эти два куска кода.

Простой код

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

import com.codeborne.selenide.SelenideElement;

import static com.codeborne.selenide.Condition.text;
import static com.codeborne.selenide.Selenide.$$;

public class SelenidePageObject {
  public void selectBoxByTitle(String title) {
    selectBox($$(".boxLabel").findBy(text(title)));
  }

  public void selectAllBoxesByTitle(String searchTitle) {
    $$(".boxLabel").filterBy(text(searchTitle)).forEach(this::selectBox);
  }

  private void selectBox(SelenideElement boxLabel) {
    boxLabel.closest(".box").find(".boxCheckbox").click();
  }
}

Правда, ПРОСТО?

Этот вариант тоже не идеален. Но главное - он гораздо короче и проще. Его проще поддерживать. Его проще понять. Его проще поменять. Его проще переписать с нуля, в конце концов.

P.S. Заметили трюк? Я сказал, что переписал код на Селенид, но на самом деле выигрыш получился не столько от Селенида, сколько от упрощения селекторов, выкидывания лишнего, использования лямбд (т.е. более современных средств языка). В общем, вы все с этим справитесь.

Цените простоту, друзья!

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

ru.selenide.org

Вышла Selenide 5.2.4

2019-06-20T00:00:00+00:00

Всем привет из лета!

Пока в Эстонии празднуют Иванову Ночь и День Победы, мы выпускаем Selenide 5.2.4

Что нового?

Исправили работу прокси с приложением на localhost

Как вы знаете, Селенид может запускать свой встроенный прокси-сервер для некоторых функций (скачивание файлов, авторизация, логирование и т.п.). Последние версии популярных браузеров (Chrome72+ и Firefox 67+) начали по умолчанию запрещать прокси перехватывать запросы на localhost. Типа из соображений безопасности.

Из-за этого сломалось скачивание файлов у тех ребят, которые запускают AUT на http://localhost:port (как я).

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

См. PR 950.

Исправили ScreenShooterExtension для JUnit5

Как вы знаете, когда Селенид кидает ошибку (как правило, это подкласс UIAssertionError), он всегда автоматически делает скриншот. Обычно этого достаточно, но иногда люди хотят использовать какие-нибудь свои ассерты (из JUnit, Hamcrest, AssertJ и т.д.) В общем случае для этих ошибок Селенид не может делать скриншот, ведь тогда Селенид должен был бы зависеть от конкретного фреймворка.

Но для трёх самых распространённых в Селениде есть поддержка: JUnit4, JUnit5, TestNG.

Так вот, в ScreenShooterExtension для JUnit5 была ошибка. До сих пор он делал скриншоты только для селенидовских ошибок UIAssertionError. А надо наоборот - для НЕ селенидовских. Вот это мы и исправили.

Улучшили сообщение об ошибке в `$$.shouldHave(texts("1", "2", "3"))`

Метод $$.shouldHave(texts()) позволяет разом проверить тексты целого ряда элементов. Удобен для проверки, например, целой строки или колонки таблицы. В некоторых (редких) случаях он мог давать не совсем понятное (хоть и корректное) сообщение. Мы его улучшили.

См. issue 454.
Спасибо A.Smashentsev за PR 944.

Метод `$.click(offsetX, offsetY)` теперь считает координаты от ЦЕНТРА элемента

Не все знают, но у метода $.click() есть метод-побратим $.click(offsetX, offsetY) для клика со сдвигом. Классический метод $.click() кликает в центр элемента. А вот с методом $.click(offsetX, offsetY) сложнее - в некоторых браузерах сдвиг считался от центра, а в некоторых - от левого верхнего угла. Даже в документации Selenium класса org.openqa.selenium.interactions.Actions есть противоречивые сведения на эту тему:

  /**
   * Moves the mouse to an offset from the top-left corner of the element.
   */
  public Actions moveToElement(WebElement target, int xOffset, int yOffset) {
    ...
    // Of course, this is the offset from the centre of the element. We have no idea what the width
    // and height are once we execute this method.
    ...
  }

Теперь официально координаты считаются от центра элемента.

См. PR 950.

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

Обновили версии зависимостей:

WebDriverManager 3.6.1

Новости

Фреймворк TestUI на базе Appium и Selenide
Во Львове проводят воркшоп “Selenide + Selenoid”. Круто!
А в Николаеве - UI Automation Cookbook “Selenide + Allure”. Тоже норм!
Статья от LambdaTest “Selenide+IntelliJ+Maven”
Статья на японском “Page Object на Selenide”
Презентаха на японском “Пример разработки инфраструктуры тестирования E2E в стиле DSL на Selenide”
Ещё статья на японском “Selenoid + Selenide + Page objects”
Ещё статья на японском про запись видео во время запуска Selenide
Амбициозная презентаха “Selenide vs. Selenium: The War Of Technologies”. Даёшь батл!

Конференции

27 июня рассказываю в DevClub, чем же плохи статические методы
Я выступаю в Киеве 20-21 сентября на конференции QA Fest. Приезжайте, приходите! Говорят, Киев в сентябре прекрасен.

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

ru.selenide.org

Вышла Selenide 5.2.3

2019-05-07T00:00:00+00:00

Когда, если не на майских?

Мы выпустили Selenide 5.2.3 с небольшими, не обратно несовместимым изменениями.

Испугались?

Саечку за испуг!

Всё не так страшно. Подробности ниже:

Добавили метод `SelenideLogger.beforeEvent()`

Иногда нужно что-то логировать ДО совершения действия. Например, писать что-то в лог ПЕРЕД любым кликом. У Селенида есть для этого интерфейс SelenideLogger, но до сих пор в нём было только один метод onEvent(), срабатывающий ПОСЛЕ действия. Теперь же мы добавили метод beforeEvent. А onEvent переименовали в afterEvent, чтобы было понятнее.

Спасибо pavelpp за PR 927!

NB! Это изменение обратно несовместимое.

Если вы реализовали SelenideLogger в своём проекте, придётся переименовать/добавить метод в вашей реализации.
Если вы используете библиотеку selenide-allure, придётся дождаться новой версии selenide-allure вот с этим PR.

Теперь можно открывать пустую страницу

Иногда в тесте нужно открыть пустую страницу - скажем, чтобы остановить все предыдущие ajax-запросы и начать тест с чистого листа.

Теперь для этого можно использовать команду open("about:blank") (раньше селенид пытался добавить baseUrl в начало адреса).

См. issue 914 и PR 915.

Рефакторинг: вынесли все `Condition` в отдельные классы

Обычного пользователя Селенида это не касается. Просто для справки.

См. PR 912.

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

раз: WebDriverManager 3.4.0 (в т.ч. поддержка Chrome 72, 73 и 74)
два: HtmlUnit 2.34.1
три: HtmlUnitDriver 2.34.0

Известные проблемы

Chrome и Chromedriver двух последних версий (73 и 74) почему-то не работают с BrowserMobProxy, бегающем на localhost. Из-за этого не работает скачивание файлов и BasicAuth через прокси. У вас тоже так?

Мы пока не придумали ничего лучше, чем запускать тесты на Chrome 71. Качаем его отсюда.

Новости

Ура, наконец-то Selenide попал в ТОП!
Top 5 Java Test Frameworks For Automation In 2019
Доклад Ярослава Святкина на QA Fest - сравнение трёх фреймворков Serenity, Selenide и Geb
Готовые решения для QA: как писать автотесты на Groovy
Чего не стоит делать с помощью Selenium (официально от авторов Selenium):
Selenium worst practices
Разрушаем языковые барьеры. Статья про Selenide на испанском языке!
Часть 1 и часть 2.
Статья про Selenide+Allure: Adding Masala to the Selenide Test Automation Framework with Allure.
Ещё одно руководство для начинающих от компании LambdaTest:
Selenium Tests Using Selenide, IntelliJ, And Maven
Статья на японском про Selenide+Allure+Cucumber+Maven: GUI test automation and result visualization.

Конференции

Я выступаю в Киеве 20-21 сентября на конференции QA Fest. Предварительно планируется два доклада. Приходите!
Ух ты! Некая Hima Bindu Peteti рассказывала про Селенид на конференции SauceCon в Остине (Техас).
Она же будет рассказывать про Селенид в Англии на конференции DevTEST Conference:
BDD with Selenide

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

ru.selenide.org

Вышла Selenide 5.2.0

2019-02-19T00:00:00+00:00

Привет!

А вот подоспел и пресс-релиз версии Selenide 5.2.0, которая вышла 19.02.2019.

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

Добавили алиасы для Котлина

Поскольку в Kotlin нельзя использовать $ и $$ в качестве названия метода, использование Selenide на Kotlin изначально было не таким уж радужным, как на Java. Здесь можно посмотреть некоторые варианты, как это можно было решить.

После долгих споров и изысканий мы остановились на просто и понятном варианте: заменить $ и $$ методами element и elements. Чуть длиннее, чем $, но зато предложение читается по-человечески:

element(".header").shouldNot(exist)
elements(".header").shouldHave(size(3))

См. issue 865.

Спасибо Jacek Kromski за PR 870!

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

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

  $("textarea").shouldHave(selectedText("oo ba"));
  $("textarea").shouldHave(text("foo bar"));

См. issue 766.

Спасибо symonk за PR 876!

Улучшили поддержку `chromeoptions.args` и `chromeoptions.prefs`

Я вообще сильно сомневаюсь, что это полезная фича. Проще уж реализовать свой WebDriverProvider. Но фича есть, и её надо поддерживать. Больше подробностей в PR.

Спасибо Alexei Vinogradov за PR 883.

Удалили старый хак для максимизации окна браузера в Chrome

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

См. issue 838 и PR 901.

Новости

Сравнительный анализ: Selenide vs Geb
Neodymium: новый фреймворк на основе Selenide от германской компании Xceptance
Статья 1 | Статья 2
Akita: Фреймворк от Альфа-банка на основе Selenide
Статья про тестирование вёрстки от Альфа-банка (естественно, с использованием Selenide)
Статья про BDD на Selenide: BDD: Writing an Automated Test Suite isn’t Rocket Science
И ещё про BDD на Selenide+Cucumber

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

ru.selenide.org

Вышла Selenide 5.1.1

2018-12-31T00:00:00+00:00

Привет!

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

Selenide позволяет кликать по прозрачным элементам

До сих пор Selenide не позволял кликать по прозрачным элементам (у которых opacity: 0). Это казалось разумным, ведь реальный пользователь тоже не может кликнуть элемент, который он не видит.
Но выяснилось, что иногда это нужно - например, когда под прозрачным элементом располагается поле для загрузки файла.

Теперь мы это не запрещаем. :)

См. issue 201

Спасибо Алексею Виноградову за PR 874 и Алексею Баранцеву за терпеливые объяснения в чатах.

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

Теперь вместо NullPointerException будет лететь понятный

IllegalStateException: config.proxyEnabled == true but proxy server is not started.

Всё для людей! :)

См. issue 878 и PR 888

Теперь можно сколько угодно переключаться между двумя вебдрайверами

Это работало в Selenide 4.x и раньше, а в версии 5.0.0 сломалось. Теперь починили.

См. issue 867 и PR 890

Селенид генерирует уникальную папку для каждого скачанного файла

До сих пор Селенид скачивал все файлы в папку build/reports/tests с их оригинальными именами. Это могло создать проблему, если два параллельных теста скачивают файлы с одинаковыми именами.

Теперь Селенид будет скачивать каждый файл в уникальную папку build/reports/UUID (но по-прежнему со своим оригинальным именем, ведь имя файла может быть важно для теста).

См. issue 892 и PR 893.

Обновились на selenium-java 3.141.59

Эту версию селениума авторы в шутку назвали “Пи”: 3.141.59 Кажется, это последняя версия в линейке 3.x - за ней будет Selenium 4.0

Список изменений в selenium 3.141.*

Новости

Три классные статьи от коммитера Селенида Александра Росолко
- Кратко и ёмко: как настроить проект с Gradle, JUnit5, Allure и Selenide, и код на гитхабе
- Как ускорить тесты с помощью мгновенной авторизации
- Как ещё ускорить авторизацию с помощью LocalStorage
Найдена старенькая, но хорошая презентация Page object with selenide
Исторический момент: кто-то защитил магистерскую работу про Selenide:
“Development of Selenide Page Object class generator”

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

ru.selenide.org

Вышла Selenide 5.0.1

2018-11-07T00:00:00+00:00

Привет! Прошёл месяц с выхода Selenide 5.0.0. Пока не слышно о каких-то громких фейлах. Никто по-большому не жалуется.

Поэтому громких багфиксов не будет. Мы просто выпустили Selenide 5.0.1 с небольшими исправлениями старых болячек.

Генерируем случайное имя файла, если нет никакого

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

File image = Selenide.download("https://utdirect.utexas.edu/apps/pts/parking/citations/nlogon/images/6584836/");

Он пытается получить имя файла из http заголовка или урла. Но если нет ни того, ни другого - метод падал. А теперь больше не падает, а просто генерирует случайное имя файла. Хотя я бы рассматривал это как багу в приложении.

См. issue 840 и PR 856

Спасибо David Phillips за идею решения.

Исправили `IndexOutOfBounds`, когда родитель не найден

Вот такой вызов раньше выдавал IndexOutOfBounds, а теперь возвращает false:

$$("not-existing-locator").first().$$("locator").isEmpty();

См. issue 747

Спасибо Denys Shynkarenko за PR 837

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

Вот такой код раньше выдавал ClassCastException:

List<SelenideElement> selenideElements = new ArrayList<>();
selenideElements.addAll($$("#table1 td"));

Я даже не хочу знать, зачем писать такой код в своих тестах. Народ, что вы там курите?

Но починить надо было, и мы починили.

См. issue 844

Спасибо Boris Osipov за PR 847

Добавили поддержку chrome 70

Начиная с версии 3.0, WebDriverManager стал хрупким. А именно, он содержит файл versions.properties, который хранит соответствия между версиями вебдрайверов и браузеров. Но сам WDM обновляется гораздо реже, чем браузеры и вебдрайверы. Естественно, каждый раз, когда выходит новая версия Firefox или Chrome, WDM перестаёт работать.

Мы пока внесли свою версию versions.properties в Селенид. Мы-то обновляемся чаще, чем WDM. :)

И уже добавили туда поддержку chrome70=2.42 и firefox62. Что делать с этим дальше - посмотрим. Возможно, придётся сделать свой WDM с блэклистом и шлюзами.

См. PR 855

Обновились на selenium-java 3.141.5

Список изменений в selenium 3.141.*

Статистика

Количество скачиваний растёт. Мы пробили планку 40800 скачек в месяц.

Конференции

Если вы ещё не бывали, очень советую съездить на конференцию Гейзенбаг. Это реально крутая конференция по тестированию и не только. Чего стоят только эти имена (из известных мне):

Барух Садогурский - человек не из мира тестирования, но зато живая легенда из мира разработки. Самые крутые Java-разработчики считают за честь сфоткаться с его картонным трафаретом, серьёзно!
Артём Ерошенко - человек-Allure и самый харизматичный спикер на конференциях по тестированию.
Алексей Баранцев - человек-селениум
Кирилл Толкачёв - ещё одна легенда в мире DevOps. Человек-Spring-Boot
Антонина Хисаметдинова - человек-юзабилити. Смешно, интересно, полезно

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

ru.selenide.org

Вышла Selenide 5.0.0

2018-10-10T00:00:00+00:00

Ура! Наконец-то это случилось. Мы выпустили мажорную версию Selenide 5.0.0

Самое большое изменение в Selenide 5.0.0 - это большой рефакторинг. То есть внутренние изменения. Вас это почти не должно задеть. Кому интересно - детали рефакторинга будут в отдельном посте.

Какие же изменения ждут вас в Selenide 5.0.0?

Возможность открывать два браузера в одном тесте

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

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

Если вы всё-таки решите идти грешным путём, это делается примерно так:

SelenideDriver browser1 = new SelenideDriver();
SelenideDriver browser2 = new SelenideDriver();

browser1.open("https://google.com");
browser2.open("http://yandex.ru");

browser1.$(h1).shouldHave(text("Google"));
browser2.$(h1).shouldHave(text("Yandeks"));

См. актуальный пример в тестах Селенида

См. issue 354 и PR 801

Хочу выразить благодарность людям, которые сыграли важную роль в этом рефакторинге:

Iakiv Kramarenko за изначальную идею,
Alexei Barantsev за конструктивные споры и убедительные аргументы,
Aliaksandr Rasolka за моральную поддержку и генерацию идей

NB! Старые добрые open, $, $$ работают по-прежнему, и я по-прежнему рекомендую их использовать. Внутри они тоже создают new SelenideDriver(), но правильно его хранят и уничтожают. Вам незачем городить свои велосипеды и решать те же задачи снова и снова.

Ещё раз: два браузера в тесте - это наверняка ПЛОХАЯ ПРАКТИКА!

Теперь Селенид по умолчанию использует Chrome

Когда-то давно мы выбрали Firefox по умолчанию, потому что это был единственный браузер, для запуска которого не требовалось установки отдельного вебдрайвера. Этот аргумент давно неактуален, т.к. 1) Firefox теперь тоже требует установки geckodriver, и 2) Селенид умеет устанавливать их автоматически.

Зато Chrome, по нашему опыту, быстрее и надёжнее. Поэтому наступила эпоха Хрома.

См. issue 811 – спасибо Aliaksandr Rasolka за PR 812

Селенид больше не максимизирует браузер по умолчанию

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

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

См. issue 810 – спасибо Aliaksandr Rasolka за PR 812

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

Действия и проверки (например, $("#name").click() и $$("#list").shouldHave(size(1))) теперь кидают ошибку, если браузер не открыт (или уже закрыт). Т.е. сначала нужно открыть браузер (вызвать open(url)), а лишь потом работать с элементами.

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

Уже известны случаи, когда тесты начали падать после перехода на Selenide 5.0.0 по двум причинам:
Поля пэдж обжекта были объявлены статическими, а браузер закрывался после каждого теста. Статические поля инициализировались только один раз. Каждый следующий тест не переинициализировал их, а получал SelenideElement от предыдущего теста с устаревшей ссылкой на вебдрайвер (уже закрытый). Решение: сделать поля нестатическими. Статики - зло.
Поля тест-класса (в случае TestNG) инициализировались не в setUp методе, а прямо в объявлении полей. За это я и люблю JUnit. Счастливые пользователи JUnit могут позволить себе такую роскошь:
public class MyTest {
  SelenideElement header = $("h1");
}
А бедные пользователи TestNG вынуждены выносить инициализацию во всякие @Before методы:
public class MyTest {
  SelenideElement header;
  @BeforeEach
  public void setUp() {
    header = $("h1");
  }
}
Ужасно, правда? Мой вам совет: забудьте TestNG как страшный сон. JUnit рулит.

См. issue 809

Подчистили старые настройки и фичи

См. issue 806 – спасибо Aliaksandr Rasolka за PR 812

В том числе убрали поддержку следующих настроек:

browser (используйте selenide.browser)
remote (используйте selenide.remote)
selenide.browser-size (используйте selenide.browserSize)
selenide.browser.version (используйте selenide.browserVersion)
browser.version (используйте selenide.browserVersion)
selenide.start-maximized (используйте selenide.startMaximized)
selenide.chrome.switches (используйте selenide.chromeSwitches)
chrome.switches (используйте selenide.chromeSwitches)
selenide.page-load-strategy (используйте selenide.pageLoadStrategy)
selenide.click-via-js (используйте selenide.clickViaJs)
selenide.reports (используйте selenide.reportsFolder)

Убрали зависимость от `junit5-api`

Раньше Селенид транзитивно тянул за собой junit5-api, даже если вы не используете JUnit5. Очевидно, вам это не надо. Теперь больше не тянет.

Если вы всё же используете JUnit5 и у вас из classpath пропали нужные классы, придётся в своём проекте явно объявить зависимость "org.junit.jupiter:junit-jupiter-api:5.3.1".

Ну и по мелочам:

Классы AssertionMode, SelectorMode, FileDownloadMode перенесены из класса Configuration в пакет com.codeborne.selenide
Теперь Селенид кидает ElementIsNotClickableException вместо ElementNotFoundException (если элемент закрыт другим элементом и поэтому не удалось его кликнуть)
Селенид кидает ошибку, если Configuration.fileDownload == PROXY, но Configuration.proxyEnabled == false. Вам придётся проставить Configuration.proxyEnabled=true, если хотите скачивать файлы через прокси.
817 fix “FirefoxDriverFactory overwrites Firefox profile provided by Configuration” – спасибо Boris Osipov за PR 821
bugfix: method Selenide.download() should not fail if there is no opened browser yet
825 Обновили WebDriverManager до версии 3.0.0 (снова)
825 Придумали костыль для WebDriverManager, чтобы он не обращался слишком часто к github (получая при этом ошибку 403)
832 Added support for screenshots outside of “user.dir” in CI server – спасибо Alex Yu

И технические изменения (которые вас, скорее всего, не затронут)

Обновились до htmlunitdriver 2.33.0
Перенесли константы IE, FIREFOX и т.д. из класса WebDriverRunner в его родительский класс Browsers
Перенесли класс Selenide, WebDriverRunner, Configuration в подпапку statics.
Перенесли логику инициализации дефалтовых настроек из Configuration в SelenideConfig.
when waiting for a condition, catch explicitly only needed exceptions instead of Throwable which is too generic. It does not make sense to wait for 4 seconds in case of IllegalStateException, FileNotFoundException etc.

Новости

Селенидовские проекты переехали в специальную “организацию” на гитхабе: github.com/selenide
Напоминаю, что примеры использования селенида с разными фреймворками лежат в организации github.com/selenide-examples
Появился шаблон проекта на Selenide для Грэдла
Наконец-то подоспело видео моего доклада Selenide: fall in love after 15 slides с конференции GeeCON 2018 в Кракове
Неинтересная статейка Selenide vs. Selenium: The War Of Technologies!!!
16 октября, Краков, Agile & Automation Days - мастер-класс по Селениду, Алексей Виноградов
7 ноября, Белград, Test Conference - Rapid UI-Test automation with Selenide, Алексей Виноградов
18 октября, Москва, встреча анонимных тестировщиков - Конфиги в тестах, Gradle, Java, Selenide, Борис Осянин
Завтра в Америке состоится митап BDD with Selenide - 16 октября 2018, Рестон, Вирджиния

Selenide is an open-source library that can make a huge impact on and accelerate software delivery by introducing a concise API, shorter expressions, and many other capabilities.

Нам 7 лет!

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

А как у вас прошло обновление?

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

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

ru.selenide.org

Вышла Selenide 4.14.0

2018-08-29T00:00:00+00:00

С тех прошёл - страшно подумать - 21 год! И раз мы до сих пор живы, мы решили в этот исторический день зарелизить Selenide 4.14.0

Изменений немного, и они касаются в основном селенидовского прокси-сервера.

Реализовали BasicAuth через прокси

Часто тестовые сервера закрыты паролем (т.н. BasicAuth). (Зачем это нужно - остаётся для меня загадкой, ведь они и так в интранете! Но что поделаешь, есть как есть.)

До сих пор Selenide позволял вам авторизоваться, только добавляя username:password@ в URL. Но говорят, это работает не во всех браузерах. Теперь же мы реализовали BasicAuth через прокси-сервер, а не URL. Грубо говоря, селенид сам добавляет в каждый запрос от браузера к приложению заголовок Authorization: Basic foobar Этот способ точно работает во всех браузерах. Смело включайте прокси (см. следующий пункт).

См. issue 784 – спасибо Aliaksandr Rasolka за PR 785

Добавили настройку для включения/выключения прокси-сервера

Как вы знаете, Селенид умеет запускать свой встроенный прокси-сервер, который отслеживает запросы между браузером и тестируемым приложением. Изначально он использовался только для одной функции - скачивания файлов. Поэтому у прокси-сервера не было какой-то отдельной настройки - он включался настройкой Configuration.fileDownload == PROXY. Теперь же использование прокси-сервера расширяется (см. предыдущий пункт), и будет расширяться ещё.

Поэтому мы добавили отдельную настройку для прокси-сервера:

Configuration.proxyEnabled = true | false (по умолчанию false)

Поясню, почему по умолчанию false. Лично я советую всем включать прокси-сервер. Он хороший. Он позволяет делать вещи, которые с голым селениумом просто невозможны.

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

Для тонкой настройки прокси-сервера (большинству из вас это не нужно):

Configuration.proxyHost
По умолчанию "" (селенид автоматически подставит IP или имя хоста текущей машины)
Configuration.proxyPort
По умолчанию 0 (селенид автоматически выберет случайный свободный порт на текущей машине)

См. issue 788 и PR 791

Удалили старый хак для IE.

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

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

См. issue 789 и PR 790

Новости

Обновилась статистику скачиваний Selenide за июль. А она скакнула! Мы перевалили 37000 скачек в месяц.

А вы что думаете?

Делитесь своими идеями, как ещё можно использовать прокси-сервер. Обсудим!

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

ru.selenide.org

Вышла Selenide 4.13.0

2018-08-20T00:00:00+00:00

Всем привет!

20 августа в Эстонии отмечается уникальный праздник - День Восстановления Независимости. 20.08.1991 Эстония заново обрела независимость. Прямо сейчас у меня за окном многотысячный хор поёт патриотические песни и гремит салют.

А я под звуки салюта выкатываю … Selenide 4.13.0

Изменений оказалось больше, чем мне казалось. :)

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

Находит последний дочерний элемент данного элемента. Типа $("table").lastChild().shouldHave(cssClass("lastRow"));

См. примеры в тестах селенида

Спасибо SymonK за PR 771

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

Как вы знаете, в Селениде издревле был метод $.waitUntil(условие, таймаут) для ожидания события с нестандартным таймаутом. Теперь мы добавили аналогичный метод и для коллекций. Правда, мы решили не называть его waitUntil, потому что это название неудачное в плане английской грамматики - $$.waitUntil(texts("a", "b", "c")) просто не звучит. В итоге метод называется так же, как и все предыдущие методы:

$$.shouldBe(empty, 9000)
$$.shouldHave(size(4), 9000)

Больше примеров в тестах селенида.

См. issue 601 и PR 781

Добавили метод `Selenide.download(url)`

… для скачивания файла по прямой ссылке. Но скачивания, конечно, не просто так, а как будто бы файл открывается в текущем браузере. Технически говоря, Selenide скачивает файл GET-запросом по вашему URL, но добавляет к нему cookies и заголовок User-Agent от запущенного вебдрайвера.

Больше примеров в тестах селенида.

См. PR 782

Обновились до Selenium 3.14.0

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

FindsByLinkText
FindsById
FindsByName
FindsByTagName
FindsByClassName
FindsByCssSelector
FindsByXPath
HasIdentity

По идее это не должно ни на что повлиять, просто на всякий случай сказал.

См. PR 773

Метод `switchTo().alert()` теперь кидает `NoAlertPresentException`

… вместо TimeoutException

См. issue 273 – спасибо Keita Tsukamoto за PR 774

Исправили сообщение об ошибке из метода `$.selectOptionByValue()`

См. issue 709 – спасибо Keita Tsukamoto за PR 780

Исправили имя скачиваемого файла

См. issue 734 – спасибо Aliaksandr Rasolka за PR 768

Обновились до WebdriverManager 2.2.5

См. PR 783 и changelog

Обновились до HtmlUnit 2.32.1

См. PR 775

Исправили все селенидовские тесты для Firefox

Все вы помните тот исторический момент, когда вебдрайвер для Firefox уже перестал работать, а geckodriver (или marionette) ещё не начал. В то время нам пришлось “временно” выключить запуск селенидовских тестов под Firefox. И вот недавно мы обнаружили, что всё это время они не запускались. Год? Два? Три? Уже никто не помнит.

И вот мы наконец их включили обратно и починили. Чинить пришлось прилично. Не исключено, что заодно мы и какие-то баги починили. :)

См. PR 778

Новости

Замечательный обрывок фразы из чата:

Юзаю джаву не только за то что она джава, а за наличие кучи готовых плюшек.
Таких как selenide, restassured итп.
Внезапно появилось сразу два фреймворка для автотестов, построенных на базе Селенида:
- Selenium Automation Bundle
- Neodymium
Мы добавили возможность генерировать базовый проект на Selenide + Maven + JUnit5 одной строкой!

Например так:

mvn archetype:generate -B
  -DarchetypeGroupId=org.selenide -DarchetypeArtifactId=selenide-junit5-archetype
  -DgroupId=com.example -DartifactId=ui-tests -Dpackage=com.example.project.ui

См. Используем Maven Archetype для генерации Selenide проекта

Следите за обновлениями!

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

ru.selenide.org

Вышла Selenide 4.12.3

2018-07-17T00:00:00+00:00

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

Сегодня мы выкатили Selenide 4.12.3

Пробежимся по изменениям?

Добавили поддержку JUnit 5

Как вы знаете, в Selenide есть специальная поддержка для двух самых распространённых тестовых фреймворков JUnit4 и TestNG. Это специальные “правила” или “Listeners”, которые позволяют периодически переоткрывать браузер, делать скриншоты и т.д.

Теперь мы добавили аналогичную поддержку и для JUnit 5:

BrowserStrategyExtension
ScreenShooterExtension
SoftAssertsExtension
TextReportExtension

Спасибо Aliaksandr Rasolka за PR 757

Кстати, мы заодно переписали собственные тесты Селенида на JUnit5 и AssertJ. Так что можете оттуда подсматривать примеры на JUnit5, если понадобится.

Таймаут для скачивания файлов

Как вы знаете, в Selenide есть метод $.download() для скачивания файла. Он использует стандартный Configuration.timeout для ограничения скачивания по времени.

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

File hugeReport = $("#huge-report").download(100500);

См. issue 758 - спасибо Yuri Ivanov за PR 761

Обновление коллекций при каждом обращении

Это изменение вызвало больше всего споров. Коллекции - это метод $$ - он возвращает список найденных элементов. Иногда список большой. Иногда это может ощутимо замедлить тест.

Было раньше

До версии 4.10.1 Selenide всегда загружал весь список заново при вызове любого метода коллекции. Поэтому простое итерирование большой коллекции (несколько сотен элементов) могло быть медленным:

$$("span").forEach(item -> item.is(visible));

Стало потом

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

ElementsCollection movieTitles = $$(".film");
assertEquals("Black Panther", movieTitles.get(0).getText());
$(By.name("sort")).selectOption("Release Date");
assertEquals("The Irishman", movieTitles.get(0).getText());

На мой взгляд, такой код скорее неестественный: если уж ты ожидаешь, что страница перегрузится и содержимое коллекции изменится, то естественно было бы вызвать метод $$ заново. Поэтому я некоторое время не соглашался отменять кэширование ради “неправильных” тестов. Но в итоге победил аргумент за “единообразность”: ведь метод $ перегружает элемент при каждом обращении (хоть это и полу-случайно получилось), значит, и $$ тоже должен. Чтобы в Селениде всё вело себя одинаково.

Что теперь

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

$$.snapshot()

Кстати, на случай если вам захочется настоящего кэширования: в коллекциях есть теперь метод $$.snapshot(), который возвращает “снимок” коллекции, т.е. объект, отражающий текущее состояние и не перегружающий элементы коллекции. Любые итерации и проверки на нём будут быстрее. Можно использовать для оптимизации тестов, когда вы точно знаете, что содержимое коллекции на этой странице не меняется динамически.

См. issue 696

Новости

Нашли презентацию про Selenide некоего Alexander Bondarev из Determine на каких-то Nerd’s Day at Provectus. Там даже и видео есть.
Это случилось! Selenide попал в чей-то Technology Radar с пометкой “Selenide as new standard”. См. тут
Опубликовали видео с митапа DelEx - осторожнее, много годноты!
Приезжайте на Agile Automation Days 15-16 октября - там будет семинар “Jump into the KISS UI-Test automation with Selenide”

Следите за обновлениями!

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

ru.selenide.org

Вышла Selenide 4.12.2

2018-06-27T00:00:00+00:00

Мы выкатили Selenide 4.12.2

Пробежимся по изменениям?

Добавили метод `because` к коллекциям

Как вы знаете, в Selenide есть метод because, позволяющий написать пояснение, почему автор теста ожидает именно такое поведение:

  $("#login").shouldBe(visible.because("After 3 wrong answers user should be logged out"));

Теперь метод because появился и для коллекций:

  $$(".error").shouldHave(size(3).because("A separate error message per wrong answer"));

См. issue 440 - спасибо Mikhail Sidelnikov за PR 749

Селенид больше не будет пытаться открыть браузер

… при выключенной настройке Configuration.reopenBrowserOnFail.

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

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

См. issue 695 и PR 754

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

selenium 3.13.0
webdrivermanager 2.2.3

События

Напоминаю, что в Минске 7 июля состоится крутой митап “DelEx Chatter”. Его устраивают наши друзья, там будут крутые спикеры в два потока. Будет круто.

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

ru.selenide.org

Вышла Selenide 4.12.1

2018-06-02T00:00:00+00:00

С большим опозданием выкладываем описание релиза Selenide 4.12.1

Лето, футбол - сами понимаете. Не оторваться.

Итак,

Исправили имя скачиваемого файла

В случае, если файл скачивается по ссылке, содержащей ? и параметры (типа /download/me/selenide-4.11.5.md?sessioncookie=12345), то Selenide пытался создать локальный файл с именем selenide-4.11.5.md?sessioncookie=12345. Теперь Selenide будет обрезать всё, что после вопросительного знака. В данном случае он создаст файл selenide-4.11.5.md.

См. issue 735 - спасибо Aliaksandr Rasolka за PR 735

Поменяли реализацию метода `Selenide.refresh()`

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

См. issue 740 - спасибо Aliaksandr Rasolka за PR 741

Исправили метод `WebDriverRunner.isHeadless()`

Раньше этот метод возвращал true только для HtmlUnit и PhantomJS. Теперь же он возвращает true также и для Chrome/Firefox, запущенных в режиме headless.

Хотя честное слово, я не понимаю, зачем вам вообще нужно использовать этот метод. Не используйте. Неужто вы без селенида не знаете, какой браузер вы запустили?

См. issue 750 - спасибо Aliaksandr Rasolka за PR 751

Добавили ID потока к логам при закрытии вебдрайвера

А то раньше не всегда понятно было, какой именно поток закрывает вебдрайвер. Хотя честное слово, я не понимаю, в какой вселенной живут люди, для которых это может быть актуально… :)

См. issue 582 - спасибо Alexander Poleschuk за PR 737

Объявили зависимость `webdrivermanager` как `api`

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

Спасибо Aliaksandr Rasolka за PR 736

Перешли с `coveralls` на `sonarcloud`

для подсчёта покрытия тестами самого селенида. А то с coveralls были определённые проблемы. Вас это напрямую не касается, просто для справки.

См. issue 702 - спасибо Aliaksandr Rasolka за PR 744

Новости

Если будете в Минске 7 июля, приходите на митап “DelEx Chatter”. Его устраивают наши друзья, там будут крутые спикеры в два потока. Будет круто.

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

ru.selenide.org

Вышла Selenide 4.11.4

2018-05-09T00:00:00+00:00

Реактивно вышел мини-релиз Selenide 4.11.4

Убрали спам в логах от Firefox драйвера

См. issue 673 - спасибо Aliaksandr Rasolka за PR 732

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

selenium 3.12.0
gson:2.8.4
guava:25.0

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

ru.selenide.org

Вышла Selenide 4.11.3

2018-05-08T00:00:00+00:00

8 мая - День работников Федеральной службы по военно-техническому сотрудничеству России. Специально к этому дню мы приурочили релиз Selenide 4.11.3.

И вот какие новинки вас ждут:

Открыли доступ к прокси-серверу

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

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

BrowserMobProxy bmp = WebDriverRunner.getSelenideProxy().getProxy();

Кстати, расскажите в комментариях, как вы его используете? Возможно, эти фичи надо встроить в Selenide.

P.S. Selenide пока ещё запускает прокси-сервер только при включенной настройке Configuration.fileDownload=PROXY. Наверное, в следующей версии нам стоит развязать эти две настройки.

Спасибо Aliaksandr Rasolka за PR 731

Добавили проверку `cssValue`

Теперь можно в тестах проверять CSS свойства элементов:

$("input").shouldHave(cssValue("font-size", "12"));

См. issue 628 - – спасибо Aliaksandr Rasolka за PR 727

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

И чтобы вам жизнь слишком лёгкой не казалось, помните, что селениумовский метод getCssValue возвращает значение так, как его отдаёт браузер. Например, у вас просто так не получится проверить цвет вот так: $("input").shouldHave(cssValue("color", "#000000")), потому что

Для хрома вернется rgb(0, 0, 0)
Для файерфокса вернется rgba(0, 0, 0, 0)

И никаких тебе хексов.

Подчистили левую зависимость `logback-classic`

Как вы помните, в предыдущей версии Selenide от WebDriverManager прилетела ненужная зависимость, и мы её рекомендовали исключить в вашем билд-скрипте. Теперь можете удалить эти строчки:

  exclude group: "ch.qos.logback", module: "logback-classic"

Подчистили задвоенные скриншоты

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

См. issue 729 - спасибо Boris Osipov за PR 730

Починили `browserBinary` в случае удалённого запуска браузера

Начиная с версии 4.9 в Selenide появилась возможность указать путь к бинарнику браузера через настройку Configuration.browserBinary. Но она использовалась только при локальном запуске браузера, а при удалённом игнорировалась.

Теперь Selenide использует эту настройку и при удалённом запуске.

См. issue 725 - Спасибо Alexei Vinogradov за PR 726

Новости

Какой-то новый видео-туториал по Selenide
9-11 мая в Кракове пройдёт конференция GeeCon, где я буду рассказывать про Selenide

Следите за обновлениями!

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

ru.selenide.org

Вышла Selenide 4.11.2

2018-04-25T00:00:00+00:00

Друзья!

Мы выпустили версию Selenide 4.11.2. Не терпится узнать, какие обновления вас ждут?

Теперь можно делать скриншоты элементов внутри `iframe`

За примерами можно сходить в ScreenshotInIframeTest:

SelenideElement iframe = $("#iframe_page");
SelenideElement element = $("#small_div");
File file = Screenshots.takeScreenShot(iframe, element);

спасибо Andrejs Kalnačs за PR 705

Добавили метод `atBottom()`

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

assertFalse(atBottom());
executeJavaScript("return window.scrollTo(0, document.body.scrollHeight);");
assertTrue(atBottom());

Примеры в PageAtBottomTest

спасибо pavelpp за PR 646

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

Как известно, методы $.append() и $.setValue() после установки значения генерировали несколько событий, в том числе change. Недавно мы пришли к выводу, что это неправильно, потому что событие change должен триггерить браузер в зависимости от действий пользователя. К тому же иногда это вызывало и реальные проблемы - например, когда это искусственное событие change вызывало переход фокуса к следующему в DOM элементу, который был вне viewPort.

Но не волнуйтесь, по умолчанию поведение Selenide не поменялось. По дефолту setValueChangeEvent=true. Это на всякий случай - вдруг у всех всё сломается. :)

Если вы согласны с доводами, выключите генерацию события change через системное свойство:

-Dselenide.setValueChangeEvent=false

или прямо в тестах:

Configuration.setValueChangeEvent = false;

Ну а если не согласны - смело делитесь соображениями. Устроим дискуссию!

спасибо MikeShysh за PR 718

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

htmlunit:2.30
webdrivermanager:2.2.1

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

SLF4J: Class path contains multiple SLF4J bindings.
SLF4J: Found binding in [jar:file:/Users/arasolka/.gradle/caches/modules-2/files-2.1/org.apache.logging.log4j/log4j-slf4j-impl/2.11.0/9ba207b78e470fe7765ebee14f1f0336c9cbcc18/log4j-slf4j-impl-2.11.0.jar!/org/slf4j/impl/StaticLoggerBinder.class]
SLF4J: Found binding in [jar:file:/Users/arasolka/.gradle/caches/modules-2/files-2.1/ch.qos.logback/logback-classic/1.2.3/7c4f3c474fb2c041d8028740440937705ebb473a/logback-classic-1.2.3.jar!/org/slf4j/impl/StaticLoggerBinder.class]
SLF4J: See http://www.slf4j.org/codes.html#multiple_bindings for an explanation.
SLF4J: Actual binding is of type [org.apache.logging.slf4j.Log4jLoggerFactory]

то стоит заигнорить транзитивную зависимость, прилетевшую из webdrivermanager. Например, в Gradle это делается так:

configurations.all {
    exclude group: "ch.qos.logback", module: "logback-classic"
}

Мы исправим это в следующей версии Selenide.

Немного статистики

Мы давно не выкладывали статистику скачиваний Selenide. А она растёт! Год назад было 8000, теперь уже 18000 скачек в месяц.

Жизнь ништяк!

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

ru.selenide.org

Вышла Selenide 4.11.1

2018-04-03T00:00:00+00:00

Друзья! С недавних пор мы перешли на “Semantic versioning”. Теперь версии будут называться 4.11.x и выходить чаще.

В версии Selenide 4.11.1 было всего одно исправление:

Исправили проблему с зависающим хромом на Windows

Бедолаги, сидящие на Windows, стали жаловаться, что после вызова метода Selenide.close() процесс chrome.exe остаётся висеть в списке задач. И хотя это не ошибка селенида, мы смогли подкрутить настройки вебдрайвера, так чтобы хром закрывался.

спасибо Aliaksandr Rasolka за PR 711

На этом пока всё, Selenide 4.11.2 не за горами!

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

ru.selenide.org

Вышла Selenide 4.11.0

2018-04-02T00:00:00+00:00

Привет, друзья!

Ой, сколько всего хочется рассказать, аж не терпится!

Но начнём с релиза 4.11.0

Итак, какие обновления прилетели в Selenide 4.11.0?

Обновились до selenium 3.11.0

Главные изменения в этом релизе связаны с браузером Internet Explorer и платформой Windows.

А также:

удалены методы startClient и stopClient в классе RemoteWebDriver.
удалены свойства SafariOptions.cleanSession и SafariOptions.port

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

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

$$.shouldHave(textsInAnyOrder("Push", "Image", "Email"))

См. issue 478 – спасибо hyunil-shin за PR 589

Теперь можно указать местоположение браузера на экране

Как обычно, либо через системное свойство:

-Dselenide.browserPosition=300x200

либо напрямую в коде:

Configuration.browserPosition = "400x300";

См. issue 687 – спасибо Aliaksandr Rasolka за PR 687

Теперь Selenide умеет скачивать файлы с русскими буквами в названии

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

  File file = $("a").download();
  assertThat(file.getName()).isEqualTo("файл-с-русским-названием.txt");

А раньше Selenide создавал файл с именем -------.txt

См. ошибку 688 и PR 689

Добавили возможность передавать `chromeoptions.prefs`

По аналогии с chromeoptions.args, теперь можно передавать такой параметр в тесты:

-Dchromeoptions.prefs=profile.block_third_party_cookies=false,profile.avatar_index=26

См. PR 692 - спасибо Tymur Kubai

Теперь вы можете добавлять в прокси-сервер свои перехватчики для запросов/ответов

Вы давно это просили, и вот мы наконец сделали!

getSelenideProxy().addRequestFilter("proxy-usages.request", new RequestFilter() {...});
getSelenideProxy().addResponseFilter("proxy-usages.response", new ResponseFilter() {...});

В RequestFilter и ResponseFilter вы можете делать буквально всё: логировать, засекать время, получать http статусы, менять тело запросов или ответов, внедрять свой JavaScript в страницы. В общем, режим бога. Подробнее о богатых возможностях прокси бог рассказывал тут.

Надеюсь, вы используете это во благо и сделаете свои тесты быстрее и надёжнее.

Как всегда, пример использования вы можете найти в тестах самого селенида

NB! Сейчас прокси-сервер запускается только при включенной настройке Configuration.fileDownload=PROXY.

Возможно, стоит развязать эти две настройки. Ждём от вас обратной связи! Смело рассказывайте, получилось ли у вас использовать прокси.

Метод `$.followLink()` помечен как deprecated

Никто уже не помнит, зачем он вообще бы создан 7 лет назад. Сейчас вместо него можно использовать обычный $.click().

Исправили случайный NullPointerException в SelenideReport

Никто не знает, как эту ошибку повторить, но на всякий случай исправили.

Спасибо dkorobtsov за PR 686

Исправили ошибку, когда при софт ассертах не делался скриншот

См. issue 655 - спасибо Boris Osipov за PR 659

Новости

Вот так новость! Allure запил поддержку Selenide
Selenide перешёл на т.н. “семантическое версионирование”. То есть теперь новые версии будут называться 4.11.1, 4.11.2, 4.11.3 (и я надеюсь, выходить чаще).
У Selenide появилось два новых коммитера. Встречайте героев:
- Борис Осипов (на самом деле уже с осени)
- Александр Расолка
Мы растём, и это вселяет оптимизм. :)

Ресурсы

Интеграция всего с Allure (в том числе Selenide, конечно)
Отличный доклад Selenium Waits: deep dive от Ярослава Пернеровского на SeleniumCamp 2018.
Главный вывод - огонь!
Selenide- быстрый старт в автоматизации тестирования
Туториал для начинающих An installer for Selenide
Selenide упомянут в книге Learning Vue.js 2
Какие-то черти сделали презентацию про Selenide на польском на AADays
Мой доклад Flaky tests с конференции SeleniumCamp 2018
Мой доклад Arrange, mazafaka! с конференции SeleniumCamp 2018

И целая пачка материалов про Selenide на японском языке:

70-страничный туториал
Ещё один hello world с Selenide и сервлетом
Заметка про проблему sendKeys в headless Chrome и её решение с помощью Selenide
http://www.atmarkit.co.jp/ait/articles/1803/05/news010.html
https://qiita.com/shimashima35/items/918b26c4260e764ce90a

Всем тёплого апреля!

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

ru.selenide.org

Вышла Selenide 4.10

2018-01-12T00:00:00+00:00

Категорический привет!

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

Итак, с чем мы встречаем старый новый год?

Что вы получите, обновившись на Selenide 4.10?

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

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

Если конкретнее, метод $.scrollIntoView() даёт команду браузеру проскроллить страницу так, чтобы данный элемент оказался в видимой области экрана.

У метода может быть как boolean параметр:

$("#my-button").scrollIntoView(true);  // верх кнопки будет у верхней границы видимой области
$("#my-button").scrollIntoView(false); // низ кнопки будет у нижней границы видимой области

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

$("#my-button").scrollIntoView("{block: \"end\"}");
$("#my-button").scrollIntoView("{behavior: \"instant\", block: \"end\", inline: \"nearest\"}");

Подробности читайте в javadoc, там всё есть.

См. issue 649

Спасибо Aleksandr Rasolka за pull request 656.

Теперь можно запускать браузеры headless на гриде

Если вы гоняете тесты на Selenium Grid, вы сможете открывать там браузеры в режиме headless. Для этого надо всего-то навсего пару строк:

Configuration.remote = "http://selenium-grid-host:port/wd/hub";
Configuration.headless = true;

См. issue 660

Спасибо Boris Osipov за pull request 661.

Теперь можно устанавливать “кастомные капабилити” для Chrome и Firefox

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

Configuration.browserCapabilities = new DesiredCapabilities();
Configuration.browserCapabilities.setCapability(SOME_CAP, "SOME_VALUE_FROM_CONFIGURATION");

См. issue 556

Спасибо Sergey Pirogov за pull request 556 и Boris Osipov за pull request 664.

Мы ускорили итерирование коллекций `$$`

Наши внимательные читатели обнаружили, что вот такое итерирование коллекции - медленное:

$$("span").forEach(item -> item.is(visible));

Потому, что на каждом шаге Selenide загружает все элементы заново. См. issue 641

Мы это дело подправили. Теперь этот цикл должен работать гораздо быстрее. Спасибо Artem Savosik за pull request 653.

Добавили заголовок “User-Agent” при скачивании файлов

Как вы знаете, Selenide скачивает файлы с помощью отдельного http-запроса, к которому он добавляет все куки из браузера. Кое-где метод $().download() не работал, потому что хитрое приложение, кроме кук, проверяло ещё и User-Agent. См. issue 639

Теперь Selenide копирует из заголовок User-Agent из браузера в запрос.

Спасибо Aleksandr Rasolka за pull request 657.

Теперь методы `byText` и `withText` понимают “неразрывные” пробелы

Представьте, что на странице есть такой элемент:

<span>Hello&nbsp;world</span>

До сих пор команда $(byText("Hello world")) или $(withText("Hello world")) его не находила. Теперь будет находить.

Мы научили методы byText и withText понимать “неразрывные” пробелы, т.е. “non-breakable spaces”, или символы &nbsp или \u00A0. Точнее, эти пробелы теперь приравниваются к обычным пробелам.

См. issue 597

Обновились до phantomjsdriver 1.4.4

Который, в свою очередь, отличается от предыдущей версии только тем, что обновлён на selenium 3.8.1. Правда, при этом несколько его собственных тестов сломались, и мы их тупо заигнорили. Так что если вы всё ещё используете PhantomJS - смотрите в оба.

Обновились до htmlunit 2.29 и guava:23.6-jre

… На всякий случай

Новости

Приглашаю всех в Киев на отличную конференцию SeleniumCamp 2-3 марта 2018!

2 дня, три трека. 500+ участников. И Киев - прекрасный город.

Программа конференции ещё формируется, но список докладчиков уже впечатляет. И я там буду, мёд-пиво пить!

Всех с @Deprecated Новым Годом!

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

ru.selenide.org

Вышла Selenide 4.9

2017-12-20T00:00:00+00:00

Всем привет!

Под звуки салютов 31 декабря мы выпустили новую версию Selenide 4.9.

Что под капотом?

Обновились до selenium 3.8.1

Там есть обратно-несовместимые изменения, так что будьте внимательны. Ребята из selenium любят удалять существующий функционал :)

А здесь есть описание по-русски.

Спасибо Aleksandr Rasolka за pull request 638.

Включили marionette по умолчанию

Как вы знаете, испокон веков дефалтовым браузером в Selenide был Firefox. Причина проста: это был единственный вебдрайвер, не требующий скачивания отдельного бинарника для управления браузером. Потом ситуация изменилась. FireFoxDriver больше не работает с новыми версиями Firefox, ему на замену пришёл GeckoDriver (aka Marionette). Он требует скачивания бинарника, но теперь Selenide умеет скачивать его автоматически.

В общем, если вы не указываете браузер, Selenide теперь по умолчанию использует Marionette, т.е. Firefox (хотя лично я предпочитаю Chrome).

Спасибо Ostap Oleksyn за pull request 621.

Починили инициализацию элементов ElementsContainer без аннотации @FindBy

См. issue 617

Спасибо Artem Savosik за pull request 618.

Хотя лично я не использую ElementsContainer и вам не советую. Это пережиток нашей бурной молодости. Сейчас Selenide позволяет писать пэдж обжекты / контейнеры гораздо проще.

Добавили методы `$$(“.item”).first(3)` и `$$(“.item”).last(3)`

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

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

См. issue 623

Спасибо Ostap Oleksyn за pull request 624.

Возможность указать путь к бинарнику браузера

Иногда вы хотите запускать тесты с разными версиями Firefox или там Chrome. На стабильной, на canary, на ночном билде. Ну, знаете, всякие люди хотят всякого :)

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

-Dselenide.browserBinary=/usr/lib/chrome.exe

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

Configuration.browserBinary = "/usr/lib/firefox";

Спасибо Ostap Oleksyn за pull request 627.

Исправили метод `prompt()` для HtmlUnit

Спасибо Anton Aftakhov за pull request 634

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

webdrivermanager:2.0.1
guava:23.5-jre
httpcore:4.4.8
htmlunit-driver:2.28.2

Новости

Долгожданное видео с Гейзенбага: Flaky tests (№2 в топ лучших докладов конференции)
Как запустить тесты с Selenide на Amazon Lambda UI Testing at Scale with AWS Lambda
Моя статья про нестабильные тесты в Java Advent Calendar: Flaky tests
Статья про Selenide на японском: Using WebDriverManager with Selenide
Ещё одна: Toward people who want to utilize Selenide
Статья из японского “Selenium/Appium Advent Calendar 2017”: Запись видео с Selenide и Monte recorder
Статья про тест-репорты с Selenide и Vigo Reporting

Всех с Новым Годом!

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

ru.selenide.org

Вышла Selenide 4.8

2017-10-08T00:00:00+00:00

Всем привет!

Мы выпустили новую версию Selenide 4.8. В основном это обновление Selenium.

Обновились до selenium 3.6

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

Спасибо Ostap Oleksyn за pull request 611.

Кстати, заодно мы обновились до guava 23.0 и org.apache.httpcomponents:httpcore:4.4.7. Мало ли, вдруг кому важно.

Исправили ошибку с софт ассертами

Спасибо Ostap Oleksyn за исправление issue 614

Вот и всё. В этот раз обновление должно быть лёгким, так что не откладывайте!

Дружеское напоминание

Приходите 8-9 декабря на конференцию Гейзенбаг в Москве!

Я буду там выступать с двумя докладами:

Flaky tests - полезность 80 lvl
Selenide Puzzlers - весёлость 80 lvl

Там и познакомимся!

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

ru.selenide.org

Вышла Selenide 4.7

2017-09-30T00:00:00+00:00

Всем привет!

Мы выпустили новую версию Selenide 4.7 с самой долгожданной фичей за последний год.

Теперь-то уж заживём!

Встроенный WebDriverManager

Теперь Selenide поставляется вместе со встроенным WebDriverManager. Это такая библиотека, которая умеет автоматически скачивать свежий бинарник вебдрайвера. То есть вам больше не нужно заботиться о том, откуда скачать geckodriver.exe или chromedriver.exe и в какую папку положить, чтобы он оказался в PATH. Selenide позаботится об этом.

Есть один нюанс. WebDriverManager сработает только в том случае, если:

Вы используете один из поддерживаемых им драйверов: chrome, edge, internet explorer, opera, phantomjs, marionette или gecko.
Какой-нибудь ваш код ещё не успел установить системное свойство webdriver.chrome.driver, webdriver.edge.driver, webdriver.ie.driver, webdriver.opera.driver, phantomjs.binary.path или webdriver.gecko.driver.

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

Если у вас ещё будут вопросы, не забывайте, что единственный достоверный источник информации - ИСХОДНЫЙ КОД!

Спасибо Сергею Пирогову и Борису Осипову за этот pull request

См. также issue 133 и 418

Добавили метод `prompt()`

Как вы знаете, в JavaScript есть три нативных диалоговых окошка: alert, confirm и prompt. Поддержка двух первых была в Selenide уже давно, а третьего не было. Конечно, для этого была своя причина: использование этих диалогов в современных веб-приложениях считается моветоном, есть миллион JS-библиотек, которые делают это в тыщу раз красивее.

Но всё же пробел исправлен:

  @Test
  public void canSubmitPromptDialog() {
    $("#login").click();
    prompt("Please input your username", "Aegon Targaryen");
    prompt("Please input your password", "qwerty");
    $("#message").shouldHave(text("Hello, Aegon Targaryen!"));
  }

Спасибо Anton Aftakhov за PR 591

Добавили путь к html-файлу в сообщение об ошибке

Одна из самых удобных фишек Selenide в том, что он автоматически делает скриншот при падении теста и добавляет путь к файлу скриншота к сообщению об ошибке. Очень удобно смотреть отчёты об упавших тестах: один клик - и ты уже видишь скриншот, и для этого не нужно запускать какие-нибудь там Thycidides, Allure, Report Portal и прочие сложные штуки. Простые вещи - самые надёжные.

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

Этот пробел и исправил hyunil-shin в PR 590. Теперь сообщение об ошибке будет содержать оба файла:

Element should have text 'Goodbye, Aegon Targaryen!' {#message}
Element: '<div id="message">Hello, Aegon Targaryen!</div>'

Screenshot: file:/.../build/reports/.../canSubmitPromptDialog/1507061177250.0.png
Page source: file:/.../build/reports/.../canSubmitPromptDialog/1507061177250.0.html
Timeout: 4 s.

Исправили путаницу со скриншотами при параллельном запуске тестов

Руководство ФБР долгое время пыталось замолчать это, но в Selenide была одна неприятная бага. А именно, при параллельном запуске тестов он мог путать скриншоты. Всё из-за злостного использования статической переменной.

Хорошо, что теперь с этим покончено. Спасибо Jane Riabchenko за PR 595

А статические переменные мы планируем искоренить в большом рефакторинге в версии Selenide 5.0

Обновились до selenium-java 3.5.3

За это время уже успел выйти selenium-java 3.6.0, на него мы обновимся в Selenide 4.8, который выйдет уже совсем скоро.

Обновились до browsermob-core 2.1.5 (и littleproxy 1.1.0-beta-bmp-17)

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

Обновили htmlunit с 2.24 до 2.27

Фиг знает, что там улучшилось, но спасибо Alexander Kotlyar за PR 609.

Вышла Selenide 4.6

2017-09-09T00:00:00+00:00

Всем привет!

Мы выпустили новую версию Selenide 4.6!

Метод `$.shouldHave(exactValue(" foo "))` больше не обрезает пробелы в начале и конце строки

Как известно, метод $.shouldHave(value(" foo ")), который все мы используем в большинстве случаев, обрезает начальные и конечные пробелы в строке. Это удобно, потому что браузеры тоже так делают. Но вот оказалось, что то же самое делал и метод exactValue(), а это уже нелогично.

Предположим, у вас на страничке есть <textarea value="Regression test description "></textarea>. Проверка $("textarea").shouldHave(exactValue("Regression test description ")); раньше валилась, а теперь нет.

См. issue 573

Спасибо @mseele за pull request!

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

В Selenide всегда был удобный метод $.toString() - он выводил актуальные детали веб-элемента: тэг, текст, атрибуты. Это очень удобно при отладке и логировании. Но у него есть недостаток: за всеми этими деталями он обращается к вебдрайверу, что занимает немножко времени и иногда может упасть.

А мы добавили новый метод $.getSearchCriteria(), который не обращается к вебдрайверу, а просто выводит локатор, по которому элемент пытались искать.

Одним словом,

  assertThat($("h2").toString(), equalTo("<h2>Dropdown list</h2>"));
  assertThat($("h2").getSearchCriteria(), equalTo("h2"));

Исправили непотребность 528

Спасибо @BorisOsipov за pull request!

Исправили непотребность 484

В некоторых редких случаях Селенид выкидывал вот такую ошибку без скриншота:

Element not found {#valid-id.findBy(text 'INVALID-TEXT')}
Expected: text '9802222-99LX'

Screenshot: null
Timeout: 0 ms.

Бывает. Исправили.

Починили запуск IE на гриде

(Неужели в 21 веке всё ещё кто-то использует грид? И кто-то использует IE? Бог ты мой, ещё и их вместе?)

См. issue 529

Спасибо @BorisOsipov за pull request!

Новости

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

ru.selenide.org

Вышла Selenide 4.5

2017-06-26T00:00:00+00:00

Привет, друзья!

Мы выпустили новую версию Selenide 4.5! В основном этот релиз посвящён улучшению производительности самого селенида.

Ускорили метод `$.setValue()`

В Selenide была крутая фича, про которую, как оказалось, никто не знал: метод $.setValue() был настолько умным, что умел проставлять значение не только для простых текстовых полей, но и для выпадающих списков и радио-кнопок. Идея была в том, что тест должен оставаться стабильным, когда разработчики поменяют тип элемента, скажем, с <select> на <input type="radio">.

Но эта “умность” была не бесплатной: во время каждого вызова $.setValue() Selenide пытался определить тип элемента, а это несколько вызовов вебдрайвера. То есть несколько десятков (если не сотен) миллисекунд.

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

-Dselenide.versatileSetValue=true

Хотя есть способ проще:

либо включите -Dselenide.fastSetValue=true,
либо используйте методы $.selectOption() и $.selectRadio().

Спасибо Alexander Popov за исправление!

Ускорили методы работы с коллекциями

Как оказалось, Селенид пытался быть слишком умным и при работе с коллекциями веб-элементов. Например, следующая проверка:

$$("tr").shouldHave(size(7));

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

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

См. pull request 549

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

… для поиска по XPath внутри веб-элемента

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

  $("table").$x(".//tr").shouldBe(visible);
  $("table").$$x(".//tr").shouldHave(size(5));

Не знаю, зачем, но людям вот нравится…

Спасибо Oleksii Cherevatyi!

Исправили поддержку Opera driver

Не знаю, зачем кому-то понадобился Opera driver, но кому-то понадобился…

Спасибо Roman Marinsky!

Подчистили лишние логи

А именно, удалили это лишнее сообщение при закрытии вебдрайвера:

INFO: Close proxy server: 24 -> null

Спасибо Andrew Zakordonets!

Обновились до org.littleshoot:littleproxy:1.1.2

Это касается только тех, кто использует опцию Configuration.fileDownload=PROXY

Обновились до phantomjsdriver 1.4.3

Я вообще не представляю, кого это касается, но имейте в виду. :)

Добавили много юнит-тестов для самого Selenide

Это мой личный праздник. Andrew Zakordonets решил помочь проекту - взял да и дописал кучу недостающих юнит-тестов для самого Селенида. Вот прямо круто!

Новости

Мы стартанули проект selenide-appium

Мы создали отдельный проект для лучшей поддержки Selenide в Appium framework: github.com/selenide/selenide-appium

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

Мы добавили несколько новых проектов в Selenide examples

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

Мы работаем над новыми примерами. В ближайших - Spring Boot, Allure 2 и бог знает что ещё. Присылайте свои примеры!

А ты помог Selenide?

Дорогой друг! И ты тоже можешь помочь проекту Selenide. Для этого даже не надо быть семи пядей во лбу или иметь 20 лет опыта в разработке.

Вот что ты можешь сделать:

Просмотреть открытые пуллреквесты и дать свою оценку в комментариях, можно ли мержить эти изменения в Selenide
Просмотреть открытые тикеты и дать свою оценку в комментариях:
- не фигню ли просят
- не сделано ли это уже
- стоит ли это делать
Дописать недостающую документацию
Написать блог-пост
Дописать недостающие тесты
Добавить свои примеры использования Selenide с другими инструментами на github.com/selenide-examples.
Найти добровольца-дизайнера для редизайна сайта (в первую очередь под мобильники)

Любая помощь приветствуется. Как говорится, нас - рать!

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

ru.selenide.org

Вышла Selenide 4.3

2017-02-09T00:00:00+00:00

Привет, друзья! Давно не виделись.

В феврале у нас вышел релиз Selenide 4.3

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

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

См. pull request 426

Спасибо Юлии Илюхиной за исправление!

Исправили поля ПО `SelenideElement` без аннотации `@FindBy`

Оказалось, все эти годы Selenide вёл себя неожиданно, когда его пытались использовать неожиданно. :)

Представим, что вы создали пэдж обжект с полями типа SelenideElement (без аннотации @FindBy):

public class StartPage {
  SelenideElement startPage = $("#start-page");
}

Этот класс - прелесть! Он простой и понятный, он работает сам по себе без всяких фабрик и прочих утилит. Достаточно просто его создать: StartPage page = new StartPage();, и он работает. Это идеальный пэдж обжект, который возможен только в мире Selenide.

Но иногда люди по привычке пытаются его инициализировать через всякие там фактори методы, как то:

  StartPage page = page(StartPage.class);

и тут начиналась чехарда. См. pull request 443

Но теперь это в прошлом.

Спасибо Сергею Пирогову за исправление!

Привели в порядок названия настроек

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

Мы привели их в порядок, так что теперь любой настройке вида Configuration.someProp всегда соответствует system property selenide.someProp. Старые настройки пока тоже сохранены для обратной совместимости.

Задепрекячили метод `Selenide.selectRadio`

Раньше выбрать radiobutton можно было таким методом: selectRadio(By.name("me"), "cat"); Теперь он помечен как @Deprecated, и вместо него рекомендуется использовать стандартный селенидовский метод:

$(By.name("me")).selectRadio("cat");

Создали ссылку на свежий Javadoc

Теперь актуальный javadoc всегда будет доступен по постоянной ссылке (без циферок):

selenide.org/javadoc/current/

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

Поскольку Selenium не обновляется уже несколько месяцев, а душа просит свежего мяса, пришлось довольствоваться мелочами:

обновились до browsermob-core:2.1.4
обновились до org.apache.httpcomponents:httpcore:4.4.6
обновились до guava:21.0

Новости

Исторический момент! BrowserStack написали туториал, как запускать тесты Selenide в их облаках:
BrowserStack+Selenide
Разоблачение Selenide от Сергея Пирогова: Тёмная сторона Selenide
Если кто не понял, данный релиз 4.3 как раз эту проблему и исправляет (см. pull request 443)
Семинар Якова Крамаренко в Сан-Франциско: Kiss PageObjects
Новая статья про Selenide на японском: I tried writing a test code with Selenide
Сравнение Selenide и GEB на японском: Selenide as seen from Geb usage
И ещё один туториал на японском: Kotlin+Selenide

SeleniumCamp!

И внимание! Приглашаю всех на конференцию SeleniumCamp, которая пройдёт уже совсем скоро:

SeleniumCamp.com

24-25 февраля

Киев

Киев - прекрасный город, а SeleniumCamp - отличная конференция. Там будут и прекрасно приготовленные базовые знания про функциональные тесты и пэдж обжекты от Николая Алименкова, и про наболевший Angular, и экзотика про Java 8 и даже Kotlin, и батл TestNG против JUnit, и очередное поливание грязью BDD и многое другое.

Но главное -

полноценный двухчасовой семинар по Selenide и
батл Selenide против JDI

Это того стоит, отвечаю!

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

ru.selenide.org

Selenide 4.2.1 released

2017-01-26T00:00:00+00:00

На английском языке.

Вышла Selenide 4.2

2016-12-30T00:00:00+00:00

Привет!

И снова эксперименты. Этот анонс написан не Андреем Солнцевым, а другими участниками Selenide комьюнити!

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

Поддержка legacy Firefox driver. #431

Как известно, Firefox, начиная с версии 48, не поддерживается встроенным драйвером Selenium, и вы должны использовать marionnete/gecko драйвер. Новый драйвер работает также и со старыми версиями Firefox, однако, во многих случаях он недостаточно стабилен. Проекты с большим количеством написанных тестов на данный момент часто используют Firefox 45 ESR, потому что затраты на анализ проблем и исправление тестов с gecko драйвером могут быть крайне высоки. В версии 4.2, мы даем вам возможность выбирать какой драйвер использовать для Firefox версий <=47.

Используйте Configuration.browser="firefox" (или через системное свойство -Dselenide.browser=firefox) для использования встроенного legacy Firefox Driver (Firefox<=47).

Используйте Configuration.browser="gecko" или Configuration.browser="marionette" (тоже самое) для использования geckodriver (все версии Firefox). Если сам драйвер у вас не находится в path, то вам так же понадобится установить путь к нему в SystemProperty webdriver.gecko.driver (например -Dwebdriver.gecko.driver=/Users/mmeier/Downloads/geckodriver-0.11)

Поддержка Microsoft Edge браузера

Мы добавили новое значение Configuration.browser="edge". Так же не забывайте указывать путь к MicrosoftWebDriver.exe в SystemProperty webdriver.edge.driver.

Лучшая поддержка https сайтов с невалидными сертификатами.

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

Поддержка кастомных capabilities и облачных сервисов (BrowserStack, SauceLabs и другие) #379

До сих пор, у пользователей Selenide не было удобной возможности передавать специфические capabilities, чтобы изменять поведение браузера. Начиная с этой версии, SystemProperties с префиксом capabilities.* автоматически обрабатываются Selenide как DesiredCapabilities. Это позволяет легко запускать ваши тесты популярными облачными сервисами не изменяя ни строчки кода!

В качестве примера для запуска теста на платформе BrowserStack (конечно, вы должны сперва зарегистрироваться и получить username и auth_key) под Windows 7 в Firefox 48 c разрешением 1680х1050 при запуске теста передайте параметры :

-Dselenide.remote=https://<username>:<auth_key>@hub-cloud.browserstack.com/wd/hub
-Dcapabilities.os=windows
-Dcapabilities.os_version=7
-Dcapabilities.browser=firefox
-Dcapabilities.browser_version=48.0
-Dcapabilities.resolution=1680x1050

Какие именно capabilities поддерживает платформа - вы можете узнать из документации соответствующего сервиса

Прочие изменения

Исправлен #433 bypass spawning local browser
Добавлен метод $.selectOptionContainingText(String) #391 - который позволяет выбирать select-опцию по подстроке.
Исправлена проблема со скриншотами слишком больших WebElement #378

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

Alexei Vinogradov & Selenide Community

ru.selenide.org

Вышла Selenide 4.1

2016-12-01T00:00:00+00:00

Свершилось!

Ура! Настал тот день. Вышел релиз Selenide 4.1, в котором всё сделано вашими руками, дорогие читатели. Ваши пуллреквесты.

#428 Improve byAttribute method for search via css selectors

Метод byAttribute (или короче by) стал мощнее. Раньше его можно было использовать для того, чтобы искать элементы по атрибуту:

$(by("first-name", "john macclane").click();

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

$(by("first-name*", "hn maccl").click();

по началу атрибута:

$(by("first-name^", "joh").click();

по концу атрибута:

$(by("first-name$", "clane").click();

по даже по вхождению слова в атрибут:

$(by("first-name~", "john").click();

Спасибо Роману Маринскому за pull request 428

#419 #425 Added methods `texts(List)` and `exactTexts(List)`

Раньше можно было проверить тексты в коллекции, передав тексты как varargs параметры:

$("#row-1 td").shouldHave(texts("pjotr", "iljich", "chajkovskij")));

То теперь в дополнение к vararg можно использовать и список ожидаемых значений:

List<String> expected = asList("pjotr", "iljich", "chajkovskij");
$("#row-1 td").shouldHave(texts(expected)));

Спасибо

Improve support for gecko (marionette) driver

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

  new MarionetteDriver(capabilities);

Selenide инициализирует вебдрайвер так:

  DesiredCapabilities capabilities = createFirefoxCapabilities(proxy);
  capabilities.setCapability("marionette", true);
  return new FirefoxDriver(capabilities);

Я пока сам не понял, хорошо это или плохо, но в следующей версии точно будут ещё улучшения для Marionette driver.

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

selenium-java 3.0.1
htmlunit-driver 2.23.2
gson 2.8.0
guava 20.0
httpcore:4.4.5

Новости

Будьте осторожны с TestNG листенерами by Сергей Пирогов
Книга Selenium Webdriver для Java автоматизаторов (в т.ч. про Selenide) by ComaQA
Статья про Selenide на японском языке
Презентация про Selenide на японском языке
Демо Selenide с Redmine и Docker

Я не знаю, что именно там делается, но зацените, какие офигенные могут быть пэдж обжекты на японском языке!

public class AdminPage extends AbstractPage {

    @FindBy(name = "commit")
    public SelenideElement デフォルト設定をロード;

    @FindBy(css = ".users")
    public SelenideElement ユーザー;
}

Или вот ещё такая красота. Поэтический язык, сразу видно.

public void 添付ファイル数は(int size) {
  添付ファイル一覧.shouldHaveSize(size);
}

Версия 4.2 будет совсем скоро. Чего-то мы там с Marionette мутим.

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

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

ru.selenide.org

Доклад о Selenide на TopConf 2016

2016-11-16T00:00:00+00:00

Привет!

Выложу презентацию про Selenide на недавней конференции TopConf в Таллинне.

Видео доклада:

И презентация:

Andrei Solntsev

ru.selenide.org

Обёртка или чистый вебдрайвер?

2016-10-20T00:00:00+00:00

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

И вот почему это плохо.

Вам шашечки или ехать?

Представьте себе: вы очень торопитесь на самолёт. Садитесь в такси, говорите: “Срочно в аэропорт!” А таксист вам говорит: сейчас я поставлю на раму мотор, прикручу колёса, залью топливо - и мы поедем!

Ты офигеваешь, но ок, раз в этой индустрии так принято - значит, надо подождать.

Покрытие

Ждёшь пять минут, нервно посматривая на часы. Говоришь: “Ну что, едем уже?” И слышишь: “Да, я уже половину гаек в моторе прикрутил.” И гордо добавляет: “У меня покрытие гайками 70%!”

Отчёты

Ещё через пять минут ты снова нервно спрашиваешь и слышишь: “Да-да, всё круто! Сиденья уже почти установлены.” И гордо добавляет: “Можете посмотреть отчёт с картинками о проделанных шагах.”

Зато если что

Ты громко ругаешься матом и говоришь: “Да какого чёрта? Почему бы нам просто не сесть в машину и не поехать?” А водитель говорит: “Пусть джуны ездят на заводских автомобилях. А настоящие водители должны знать, как оно там внутри работает.” И гордо добавляет: “Зато если что, я смогу разобраться, что сломалось.”

Готовые решения

Стоит ли говорить, что через пять минут после начала движения у вас заливает свечи. Водила говорит: “Да, это типичная проблема. Я знаю, что делать. У меня так уже было. Там надо слип поставить в двух местах.”

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

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

Сел и поехал

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

А это автоматизатор, использующий Selenide.

Так что же, не развиваться?

Надеюсь, на этом месте вам смешно. А многим - обидно. И это хорошо! Чем обиднее, тем лучше. Тем больше шансов, что это заставит задуматься о том, куда катится наша индустрия.

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

Так что же, пользоваться готовым и не вникать в подробности? Неужто настоящий водитель не должен разбираться в том, как устроен двигатель и куда заливать масло? Неужто настоящий водитель не должен уметь починить машину, если она вдруг сломается посреди дороги?

Если все будут ездить на всём готовом, у нас же настоящих спецов скоро не останется!

Развиваться!

Конечно, развиваться надо! Обязательно.

Плох тот автоматизатор, который не мечтает написать свой фреймворк.

Но не за счёт клиента!

Разбирайте двигатель. Копайтесь в железках. Играйтесь с солидолом. Но у себя в гараже. А на работе - будьте добры работать. Когда у вас есть свободное время и силы - совершенствуйтесь. Когда клиенту нужно в аэропорт - везите в аэропорт и используйте для этого наиболее эффективные средства. То есть Selenide, да.

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

ru.selenide.org

Вышла Selenide 4.0

2016-10-15T00:00:00+00:00

Привет!

Это свершилось!

После трёх лет ожидания вышел Selenium Webdriver 3.0!

А мы выпустили Selenide 4.0.

Что изменилось?

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

Но что важно - теперь Selenide требует Java 8.

Ура, теперь весь QA мир перейдёт наконец на Java 8.

Вот мы теперь с лямбдами-то заживём!

А можно поподробнее?

Конечно. Вот полный список изменений Selenium WebDriver 3.0.0.

Новости

Отличная статья Николая Алименкова: Технический долг как избыточный вес
Про другой большой апдейт для юнит-тестов: Миграция на Mockito 2.1
Про доброе старое: Spring boobs
Отличный портал для оттачивания навыков тестирования
Интересное интервью с @jbaruch про open-source, стартапы и будни developer advocate

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

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

ru.selenide.org

Вышла Selenide 3.11

2016-10-14T00:00:00+00:00

Привет!

Мы выпустили Selenide 3.11! Не то чтобы тут много чего поменялось, скорее это просто исторический релиз. Это последний релиз из серии 3.x - последний, что работает на Java 7 и с Selenium WebDriver 2.x

Дальше будет Selenide 4.x: Selenium WebDriver 3.x и Java 8.

Итак, что же вошло в последнюю троечку:

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

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

  $("#i-agree").shouldBe(checked);

Раньше приходилось писать $.shouldBe(selected), что неочевидно. Раз есть чекбокс - значит, он должен быть “checked”.

См. issue 416

Оптимизация `getMessage()`

В селениуме есть такая странная особенность. Когда вы получаете ошибку из вебдрайвера (то есть любой подкласс SeleniumException), у него вызывается метод getMessage().

А вот этот метод SeleniumException.getMessage() пытается быть слишком умным и добавляет в сообщение об ошибке IP и имя текущего компьютера. А это может занимать очень продолжительное время в зависимости от фазы луны. И оказалось, что Selenide дёргает этот несчастный метод несколько раз подряд.

У меня однажды так и было: я оказался в необычной WiFi сетке, и внезапно мои тесты стало дико тормозить. Пара часов ушло на поиск причины, но это ещё полбеды. Беда в том, что исправить это невозможно - этот код зашит в Selenium WebDriver.

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

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

Что мы и сделали.

См. issue 415

Все в предвкушении Selenium 3.0…

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

ru.selenide.org

Вышла Selenide 3.10

2016-09-26T00:00:00+00:00

Привет!

Мы выпустили Selenide 3.10!

Прокси-сервер выключен по умолчанию

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

Проблема с новым способом скачивания файлов через встроенный в Selenide прокси-сервер. На всех моих проектах он работает, но многие жалуются, что у них не взлетело. Почему - пока неясно. Возможно, не работает у тех, кто использует Selenium Grid.

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

-Dselenide.fileDownload=PROXY

Или прямо в коде:

Configuration.fileDownload = PROXY;

Кстати, мы исправили ошибку 393: Selenide даже не пытается стартовать прокси-сервер, пока соответствующая настройка не будет включена.

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

Знаете, бывают такие выпадающие списки, в которых можно выбрать несколько опций (<select multiple>). Теперь в Selenide можно тыкать и в такие. Несколько опций можно выбрать всего одной командой:

select.selectOption("Маргарита", "Theodor Woland");  // по тексту
select.selectOption(0, 2, 3);                        // по индексу
select.selectOptionByValue("cat", "woland");         // по значению

А также мы добавили метод для получения списка всех выбранных опций:

select.getSelectedOptions().shouldHave(texts("Маргарита", "Theodor Woland"));

См. issue 400

Можно печатать отчёт только для упавших тестов

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

Для JUnit:

   @Rule
   public TestRule report = new TextReport().onFailedTest(true).onSucceededTest(false);

Для TestNG:

  @Listeners(TextReport.class)
  public class GoogleTestNGTest {
    @BeforeMethod
    public void setUp() {
      TextReport.onSucceededTest = false;
      TextReport.onFailedTest = true;
    }
  }

См. issue 408

Исправили парсинг заголовка `Content-Disposition` с указанием кодировки

Теперь Selenide использует правильное имя файла в случае, если заголовок Content-Disposition включает кодировку:

Content-Disposition: filename=Prices.csv;charset=UTF-8

См. issue 398

Исправили багу 401: “Selenide swallows exception in some cases”

Никогда не пишите catch (Throwable). Никогда!

См. issue 401

Метод `open(url)` теперь работает и для URL большими буквами

Это странно, но кому-то понадобилось ввести url большими буквами, и оказалось, что Selenide не умеет открывать такие файлы. УПС. Исправили.

См. issue 407

Вернули старый закомментированный тест

Хотя, кажется, его скоро снова придётся закомментировать, потому что в Selenium 3.0 этот баг вернулся. :(

См. issue 379

Новости

Интервью Николая Алименкова на хабре: Сферическое тестирование в вакууме
Мнение эксперта: Почему разработчики не используют TDD
Тестировать мобильники - как два пальца об экран! Примеры Selenide+Appium
Новая опупенная конференция от jug.ru: Гейзенбаг - горячо рекомендую!

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

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

ru.selenide.org

Вышла Selenide 3.9.2

2016-09-03T00:00:00+00:00

Привет!

Мы выпустили Selenide 3.9.2!

Скачивать файлы можно по-разному

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

Поэтому мы решили дать пользователю выбор.

Теперь вы можете выбирать, каким способом скачивать файлы.

“Новый” способ - PROXY

Это способ включен по умолчанию.

Этот способ скачивает файлы с помощью встроенного прокси-сервера.

Плюсы:

Этот способ лучше тем, что он более универсальный: он работает не только с <a href, но и при сабмите форм, да и вообще в любом случае, когда сервер выдаёт ответ с файлом.

Минусы:

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

“Старый” способ - HTTPGET

Если вы хотите использовать старый способ, пропишите настройку -Dselenide.fileDownload=HTTPGET. Или прямо в коде:

Configuration.fileDownload = HTTPGET;

Плюсы:

Работает независимо от наличия прокси-сервера.

Минусы:

Работает только элементами с <a href и умеет делать только GET запросы.
Может не работать, если с машины, где запускаются тесты, нет доступа к тому серверу, с которого скачиваются файлы.

Теперь вам точно ничто не мешает обновиться на Selenide 3.9.2

Новости

Новый QA дайджест №21: Немного о Jmeter, о языке автоматизации, полезные расширения для браузера

Немного статистики

Статистика скачиваний Selenide за август 2016:

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

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

ru.selenide.org

Вышла Selenide 3.9.1

2016-08-27T00:00:00+00:00

Привет!

Мы выпустили Selenide 3.9.1!

Киллер фича! Selenide умеет скачивать любые файлы! Откуда угодно.

Мы хотели сделать это давно, и вот наконец свершилось! Бесконечные проблемы со скачиванием файлов в селениуме ушли в прошлое. Теперь это легко. Всегда. Один простой метод на все случаи жизни:

File report = $("input#submit").download();

В Selenide метод download существует давно. Но до сих пор он умел скачивать файлы только по ссылке с атрибутом href: <a href.

Это было круто, но в некоторых случаях недостаточно. Например:

Клик по кнопке сабмитит форму, а в результате сабмита начинает скачиваться файл.
Клик по кнопке открывает PDF в новом табе (режим “inline” - встроенный просмотрщик PDF в браузере)

Теперь же Selenide умеет скачивать любые файлы. Для этого он использует встроенный proxy-сервер (а именно, BrowserMobProxy)

Как именно работает скачивание:

Тест вызывает команду $("selector").download();
Selenide активизирует прокси-сервер
Selenide кликает элемент
Прокси сервер запоминает все ответы сервера (response), которые содержат http-заголовок Content-Disposition. Из него Selenide достаёт имя файла и сохранят файл с таким именем в папке build/reports/tests.
Selenide ждёт (до 4 секунд), пока в списке не появится хотя бы один файл
Метод $.download() возвращает первый скачанный файл.
Если за это время появились новые окна, Selenide закрывает всех их. Это нужно для тех случаев, когда PDF открывается в новом окне браузера.

См. issue #196 и pull request #267.

Огромное спасибо Дмитрию Демину за вклад в эту фичу, предложения и обсуждения!

Прокси-сервер

Да, теперь Selenide запускает свой прокси-сервер во время запуска тестов.

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

Кидайте идеи, давайте побрейнстормим!

Предупреждение о слишком больших запросах и ответах

А вот и первое использование прокси-сервера (помимо скачивания файлов). Теперь Selenide отслеживает размер запросов-ответов и пишет предупреждение в лог, если размер какого-то реквеста или респонса превышает 2 MB.

Пока это экспериментальная фича. Расскажите, как она прижилась у вас. Обнаружили что-то полезное? Были ли проблемы?

См. issue #383

Теперь листенер `SoftAsserts` нормально работает с TestNG

Оказалось, TestNG конкретная редиска и вообще нехороший фреймворк. Если вы объявляете @Listeners(SoftAsserts.class) у одного класса, TestNG автоматически применяет его ко всем вашим классам. Нет, ну это надо было додуматься, а!

Мы нашли решение для этой проблемы. Теперь листенер SoftAsserts сам проверяет, объявлен ли он у текущего тестового класса (или его предка).

См. issue #384

Теперь аннотация `SoftAsserts` для TestNG игнорирует тесты с атрибутом “expectedExceptions”

Если у вас есть такой тест:

  @Listeners(SoftAsserts.class)
  public class MyTest {
    @Test
    public void myCheckA() {...}

    @Test(expectedExceptions = ...)
    public void myCheckB() {...}
  }

то очевидно, что SoftAsserts должны включаться в методе myCheckA, но не должны в методе myCheckB. Потому что он ожидает какую-то конкретную ошибку, и если SoftAsserts её спрячет, испортит всё дело.

См. issue #372

Исправили ошибку с basic auth в браузере IE

См. issue #366 и pull request #369

Спасибо Anton Aftakhov за этот pull request!

Обновились до библиотеки gson 2.7

Сам Selenium использует довольно старый gson 2.3.1, а в некоторых проектах бывает нужен более новый.

Новости

Моё интервью на хабре: О Legacy-коде без максимализма
Почему разработчики должны быть хорошими тестировщиками
Вышел video-recorder 1.0.8 - и это чумовая вещь! Теперь production ready.
Подкаст RadioQA Выпуск 28: Стыд и scrum

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

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

ru.selenide.org

Вышла Selenide 3.8

2016-08-06T00:00:00+00:00

Привет!

Мы выпустили Selenide 3.8! В нём мы подправили много мелких недочётов и сделали некоторые небольшие, но полезные полезности.

Исправлена загрузка файлов (upload) на удалённых браузерах в гриде

Спасибо Alexei Vinogradov за исправление грида!

Теперь можно отключать создание *.html файлов

Когда ваш драгоценный тест падает, по умолчанию Selenide создаёт 2 файла:

Скриншот - файл *.png
Исходный код текущий страницы - файл *.html

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

Теперь можно отключить сохранение html-файлов - как обычно, либо через системную переменную:

  mvn test -Dselenide.savePageSource=false

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

  Configuration.savePageSource = false;

Спасибо Boris Osipov за этот pull request!

Добавлен метод `$.dragAndDropTo(WebElement)`

До сих пор в Selenide был только метод $.dragAndDropTo(String), где строковой параметр - это CSS селектор целевого элемента. А иногда хочется определять целевой элемент и по-другому.

Для таких случаев теперь есть метод $.dragAndDropTo(WebElement) позволяет перетащить элемент в другое место. Например:

  SelenideElement target = $(byText("Drop here"));
  $("#from").dragAndDropTo(target);

См. issue #355

Теперь аннотации `SimpleReport` и `SoftAsserts` для TestNG - потокобезопасные

Если вы используете аннотации SimpleReport или SoftAsserts и фреймворк TestNG (бедняги!), да ещё и запускаете тесты параллельно в несколько потоков, то вы могли замечать, что иногда отчёт о прохождении тестов пустой. А иногда могли ловить ConcurrentModificationException.

Оказалось, TestNG конкретная редиска и вообще нехороший фреймворк. Если вы объявляете @Listener(SoftAsserts) у одного класса, TestNG создаёт только один инстанс класса SoftAsserts и использует для всех тестов, даже параллельных.

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

В общем, теперь мы это исправили, и SoftAsserts умеет работать параллельно в нескольких потоках даже в TestNG.

См. issue #364 и #303.

Добавили методы в класс `Selectors`: `byCssSelector()` и `byClassName()`

Я до сих пор не уверен, что это так уж нужно, но народ просил.

Теперь в классе Selectors есть by* аналоги всех методов из селениумовского By.*.

См. #360.

Исправили JavaScript ошибку при запуске браузера Edge

Теперь Selenide можно использовать и с новым микрософтовским браузером Edge. Говорят, он быстр и свеж, как Тимати.

См. #339.

Теперь метод `$.screenshot()` сохраняет скриншот в правильное место

Есть в Selenide такой метод, который сохраняет скриншот не всей страницы, а одного элемента:

  String screenshotFile = $("#footer").screenshot();

Всё бы хорошо, но он сохранял скриншоты в корневую папку проекта. Теперь мы его исправили, и он складывает файлы в папку build/reports, как и остальные методы для снятия скриншотов.

См. #290.

Добавлена защита против неправильного использования soft asserts

Теперь Selenide кинет ошибку, если вы включите режим “Soft asserts”, но забудете добавить соответствующую аннотацию к тест-классу.

См. #302.

В Javadoc всех методов `SelenideElement` добавлены ссылки на имплементации этих методов

Например, метод $(“input”).setValue(“hello”) реализован в классе SetValue

См. #367.

Обновились до htmlunit 2.23

См. список изменений

Новости

Статья про Selenide на испанском от Dario Lamy
Почему разработчики должны быть хорошими тестировщиками - мутный чувак, но мысли правильные
Новая крутая конференция в Питере от создателей Joker и JPoint: Гейзенбаг - многообещающе! Планирую там выступить.
Новая классная статья от дядюшки Боба: ПЕНА
Что на самом деле нельзя хардкодить
Настоящие пэдж-объекты

Десерт

И на десерт - свежая шутка про Чака Норриса:

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

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

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

ru.selenide.org

Вышла Selenide 3.7

2016-07-08T00:00:00+00:00

Привет!

Мы выпустили Selenide 3.7!

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

Это должно исправить очередную проблему с Firefox 47.

Добавили поддержку браузера Marionette

Чтобы запустить свои тесты с браузером Marionette, используйте параметр в командной строке (или билд-скрипте):

-Dselenide.browser=marionette

или задайте браузер прямо в тестах:

  Configuration.browser = "marionette";

см. pull request #349

Спасибо Geroen Dierckx за этот pull request!

Добавили поддержку драйверов для не-браузеров

В последнее время появились драйверы для не-браузеров, а, например,

нативных Windows приложений (Winium),
Java Swing приложений (Marathon)
и даже мобильных приложений (Appium).

Естественно, такие драйверы не поддерживают JavaScript. Оказалось, что Selenide на это не был рассчитан и без JavaScript отказывался работать.

Теперь мы эту проблему устранили, и Selenide должен работать и с не-веб драйверами.

см. issue #345

Убрали бесполезное сообщение `Screenshots:` , если скриншоты отключены

см. pull request #357

Спасибо Boris Osipov за этот pull request!

Вот такое обновление.

Новости

Позвольте вам посоветовать ещё три отличных доклада с SeleniumCamp 2016.

Хорошие тесты меняют ваше приложение / Игорь Хрол
Время прикрыть заднюю часть / Алексей Буль
Фреймворки-шмымворки / Микалай Алименков

Немного статистики

Статистика скачиваний Selenide за июнь 2016:

И статистика уникальных IP:

Вот какую мы тему замутили!

Больше новостей на сегодня нет, но вы держитесь там! Удачи, хорошего настроения!

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

ru.selenide.org

Вышла Selenide 3.6

2016-06-01T00:00:00+00:00

Привет вам, рыцари ордена качества!

В последний день весны мы всё-таки выпустили Selenide 3.6!

Вернули стратегию загрузки страницы обратно на `normal`

В Selenide 3.5 мы прописали дефалтовую стратегию страницы в none. Для некоторых пользователей это ускорило тесты, но другие стали жаловаться, что тесты повалились, и они вынуждены были вернуться на Selenide 3.4

Теперь мы вернулись обратно на normal, а кто хочет ускорения тестов, прописывайте

-Dselenide.page-load-strategy=none

или

Configuration.pageLoadStrategy = "none";

см. issue #321

Теперь пэдж обжекты не обязательно должны быть публичными

… или иметь публичный конструктор

public class GoogleSearchTest {
    private SearchPage search;

    private static class SearchPage {
      public ResultsPage searchFor(String keyword) {
        $(By.name("q")).val(keyword).pressEnter();
        return page(ResultsPage.class);
      }
    }
}

Сделайте его приватным, удалите ненужные конструкторы! Нечего плодить хлам.

см. issue #335

Добавлена поддержка вебдрайвера JBrowser

JBrowser - это очередная попытка создать headless браузер (как HtmlUnit и PhantomJS). Типа чтобы тесты бегали быстро и не мозолили глаза. Правда, пока он кажется ненадёжным: большинство собственных тестов Selenide на нём валится.

Но вы можете попробовать сами: -Dselenide.browser="jbrowser". И придётся ещё добавить зависимость в проект:

<dependency org="com.machinepublishers" name="jbrowserdriver" rev="[0.13.0, 2.0)" conf="test-default"/>

см. issue #329

Спасибо Anil Kumar Reddy Gaddam за этот pull request!

Метод $().download() теперь использует стандартный селенидовский таймаут

А раньше он мог зависать надолго. Один раз наш билд подвис на два часа на методе $.download()!

см. issue #341

Добавлена поддержка Basic Auth для основных браузеров

Примеры использования можно подсмотреть здесь:

Selenide.open("http://httpbin.org/basic-auth/user/passwd",
        "",
        "user",
        "passwd");

см. issue #320

Спасибо dimand58 за этот pull request!

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

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

BufferedImage elementScreenshot = $(".logo").screenshotAsImage();

Спасибо Akkuzin за этот pull request!

Починили TestNG TextReport Listener

теперь отчёт будет генерироваться только для классов, аннотированных @Report.

Если я правильно понял, это вроде как бага TestNG: если листенер объявлялся хотя бы в одном тесте,

@Listeners(TextReport.class)

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

Теперь мы сделали так, что отчёт будет генерироваться не для всех классов, а только для тех, что помечены аннотацией @Report.

Спасибо Alexei Vinogradov за работу над несчастными листенерами TestNG!

Обновили phantomjsdriver до версии 1.3.0 (совместима с selenium-java 2.53.0)

Проект PhantomJS Driver, к сожалению, на долгое время остановился в развитии. Его автор Ivan Marino сначала сообщил, что больше не может активно заниматься проектом, а потом и вовсе пропал. :(

Но мы взяли его под свой контроль! Мы создали форк, который может считаться официальным продолжением, и зарелизили версию phantomjsdriver 1.3.0, которая совместима с последним Selenium Webdriver 2.53.0. И эта версия теперь поставляется вместе с Selenide.

Вот такая у нас вышла чумачечая весна.

Скачивайте и тестируйте в своё удовольствие!

Новости

В конце февраля в Киеве состоялась моя любимая (юбилейная пятая) конференция SeleniumCamp. Я сам туда попасть не смог по семейным обстоятельствам, но и без меня там было сразу несколько докладов про Selenide. Это же просто праздник какой-то, а?

Это не фантастика и не бред! Как использовать Selenide на C# .NET / Олег Володин
Альтернативный Selenide - устройство Selenide или подобного фреймворка разбирается по кишочкам / Яков Крамаренко
Ещё одна статья про Selenide на японском (у всех же Chrome переводит автоматически?) / tatesuke
В Японии нас любят!
Статья в нашем блоге: Реальный опыт с Selenide: покупка авиабилетов / Василий Ковальченко
Туториал: Selenium Tests with Maven and Selenide / Константин Павлов
Статья на хабре: Ускорение автоматизации тестирования веб-интерфейса за счет применения Python и Selenide / Николай Федоров, Николай Смирнов

Немного статистики

Статистика скачиваний Selenide за май 2016:

Нас всё больше!

Забавно, что популярность Selenide никак не коррелируется с выходом новых фич и релизов. Совпадение?..

А что у вас новенького?

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

ru.selenide.org

Реальный опыт с Selenide: покупка авиабилетов

2016-04-17T00:00:00+00:00

Привет!

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

В серии Selenide Examples сегодня мы протестируем совершенно настоящий сайт airtickets.ru с настоящими покупками, деньгами и карточками. Всё как в жизни.

Для разнообразия попробуем использовать шаблон PageObject, причём в разных вариациях:

PageObject a’la Selenide style, предложенный Андреем Солнцевым
классический PageObject
PageObject с блоками (a’la HtmlElements)

Что тестируем

Тест покупает авиабилеты СПб-Москва туда и обратно, вводя все необходимые значения, и доходит до кнопки “Купить” после заполнения данных кредитной карточки.

Вот как это выглядит:

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

Давайте посмотрим, как этот тест устроен изнутри.

Проект на гитхабе

Что такое паттерн PageObject

PageObject - это способ работы с Web UI, при котором селекторы(локаторы) элементов веб-страницы задаются в отдельном классе. Делается это для того, чтобы при изменении структуры html достаточно было обновлять селекторы всего в одном месте и не искать их по всему коду.

Какие у нас страницы

Как видно из видео, мы работаем с 5-ю страницами.

В самом тесте (класс TestBuyingTickets) описана логика работы всего теста. Из названия методов понятно, что делает каждая строчка. Посмотрим поподробнее на некоторые из них:

первая строка теста

открываем страницу и в этой же строчке “засовываем” в переменную firstPageDirection все данные об элементах/логике первой страницы.

  FirstPageDirection firstPageDirection = open("http://www.airtickets.ru/...", FirstPageDirection.class);

Теперь

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

указать город отправления:
firstPageDirection.addDirectionFrom("Санкт", "LED");
указать город прибытия:
firstPageDirection.addDirectionTo("Москва", "MOW");
…

стоит пояснить, зачем нужен цикл while - иногда после выбора рейсов и нажатия кнопки “далее” на второй странице может выпасть редкое сообщение о том, что рейсы не доступны, и предложение выбрать другие рейсы. Этот цикл как раз проверяет, что это сообщение не появилось. Если оно появится, то цикл будет повторять выбор билета, пока сообщение будет появляться.

Окончанием теста

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

  fifthPage.getButton().shouldBe(Condition.visible);

Какие тут пэдж объекты?

Первые три страницы реализованы в виде “селенидовских” PageObject. Т.е. делаем отдельные классы для каждой страницы (FirstPageDirection, SecondPageVariants, …) и в каждом описываем логику, которая нам нужна, в виде отдельных методов. При этом селекторы необходимых элементов прописываются в методах.

Например, добавить пункт отправления на первой странице (класс FirstPageDirection):

  public void addDirectionFrom(String city, String airport) {
    $("#from").setValue(city);
    $("#autocomplete").$(withText(airport)).click();
  }

Селекторы

По умолчанию $ (поиск элемента по селектору) принимает как аргумент CSS селектор. Поэтому $("#from") - означает “найти элемент с ID “from”.

Можете убедиться в том, что input “Откуда” имеет среди аттрибутов именно такой ID откройте в любом браузере страницу сервиса, наведите мышку на строку ввода пункта отправления “Откуда” и в контекстном меню (правая кнопка мыши) выберите “Просмотреть код”. Браузер откроет html код страницы и подсветит нужный нам input. Среди атрибутов этого элемента есть id=”from”.

Методы пэдж объекта

Далее вносим значение в этот input с помощью метода Selenide.setValue(String). Почему это написано в одну строку? Потому что первая часть $("#from") означает, что мы получили SelenideElement, у которого есть метод setValue(String). Также Вы можете использовать как аргумент $() и xpath, тогда вызов будет выглядеть так: $(By.xpath(....)).

Также в FirstPageDirection вы можете увидеть вспомогательные методы, которые нужны только для работы с первой страницей - получение текущего месяца из System. Это нужно для проверки, что сервис автоматически подставляет как месяц отправления либо текущий месяц, либо следующий. Проверка осуществляется с помощью assert’ов в тесте. Это, например, строка:

Assert.assertThat("Месяц отправления не равен текущему месяцу или следующему месяцу", 
  firstPageDirection.getMonthDeparture(), anyOf(is(firstPageDirection.getCurrentMonth()), is(firstPageDirection.getNextMonth())));

Кстати, крайне рекомендую освоить assertThat от hamcrest (которая уже давно в составе JUnit). Отличие assertThat от assertTrue, assertEquals и др. в читаемости, а также в том, что вы всегда при непрохождении проверки будете получать в логи фразы типа: пришло “то-то”, а ожидали “то-то”. Очень удобно.

Работа с коллекциями

В PageObject второй страницы (SecondPageVariants) используется селенидовский метод $$. Он возвращает массив всех элементов, найденных по заданному селектору.

Есть задача случайно выбрать рейс из предлагаемых. Для этого находим на странице все рейсы:

List<SelenideElement> radioList = priceTable.$$(".radio");

Здесь опять использован CSS-селектор, только в этом случае мы ищем элементы по аттрибуту class. Получаем массив всех существующих на странице .radio и выбираем среди них случайный:

SelenideElement radio = radioList.get((int)(Math.random() * (radioList.size()-1)));

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

Классический пэдж объект с блоками

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

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

  @FindBy(xpath = "(.//*[@class='frame'])[1]")
  private FramePassengerInfo passengerInfo;

  @FindBy(xpath = "(.//*[@class='frame'])[2]")
  private FrameContactPersonInfo contactPersonInfo;

Как видите, тип фреймов у нас не WebElement и не SelenideElement, а соответствующий для каждого фрейма блок, который вы можете посмотреть в пакете ForthPagePassengerInfoElements.

Каждый блок описан в классическом PageObject, с аннотацией @FindBy и своими уникальными методами. Для того, чтобы показать, что каждый фрейм - это блок, необходимо наследовать ElementsContainer (в объявлении класса : public class FramePassengerInfo extends ElementsContainer).

Итоги

Те, кто ранее писал тесты на чистом Selenium, надеюсь, увидели, что Selenide позволяет значительно сократить написание тестов.
Паттерн PageObject, как и свойственно любому шаблону, является только идеей подхода написания кода. Вы можете описать селекторы в начале с аннотацией @FindBy (классический вариант), или же вы можете написать PageObject как предлагает Андрей Солнцев - страница содержит методы, внутри которых пишутся селекторы. Вы даже можете создать синглтон, который будет содержать мапу со всеми селекторами вашего проекта. И в описании логики тестов выдергивать селекторы из мапы и вставлять их как аргумент в селенидовский $ (именно такое решение применил у себя на проекте, где очень много элементов с похожими названиями, мало уникальных классов и айдишников). Главное, старайтесь описывать селектор для конкретного элемента в одном месте. Чтобы вы или тот автоматизатор, что придет на ваше место в будущем, могли это место легко отыскать и изменить селектор, если разработчики решат поменять html структуру.

Василий Ковальченко

Вышла Selenide 3.5

2016-03-31T00:00:00+00:00

Привет!

Вышла в свет Selenide 3.5 с поддержкой резиновых коллекций. А именно,

Добавили гибкие условия для проверки размера коллекций

Раньше в Selenide можно было только проверять точный размер коллекции:

  $$(".man.angry").shouldHave(size(12));

Теперь же - на радость шурупозабивателям - можно проверять и более гибко: больше, меньше и т.п. А именно:

  $$(".man.angry").shouldHave(sizeLessThan(13));
  $$(".man.angry").shouldHave(sizeLessThanOrEqual(12));
  $$(".man.angry").shouldHave(sizeGreaterThan(11));
  $$(".man.angry").shouldHave(sizeGreaterThanOrEqual(12));
  $$(".man.angry").shouldHave(sizeNotEqual(42));

Спасибо vasilevichra за этот pull request!

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

Ускорение загрузки страниц

По умолчанию Selenium webdriver ждёт, пока все элементы страницы (html, script, style, img) загрузятся. Это может быть долго, если например, на странице есть большие картинки. И это наверняка не нужно, особенно в случае с Selenide, который по любому умеет ждать наступления ожидаемых условий.

Поэтому в Selenide 3.5 мы включили стратегию загрузки none. Это должно сделать ваши тесты быстрее.

Если нужно, стратегию можно поменять через настройку:

-Dselenide.page-load-strategy=normal

или прямо в коде:

Configuration.pageLoadStrategy=eager;

Описание всех доступных стратегий есть здесь.

Исправили метод toString()

Selenide умеет выводить подробную информацию о веб-элементах. То есть когда вы пишите System.out.println($("option#abc")), вы увидите в консоли текст и значения всех атрибутов этого веб-элемента:

<option id="abc" value="livemail.ru" selected:true>@livemail.ru</option>

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

Поэтому нам пришлось использовать грязные JavaScript-трюки. Я потом месяц отмывался!

Но оказалось, что этот метод печатает изначальное значение атрибута value, даже если он был позже изменён динамически. Эту проблему мы исправили в Selenide 3.5. Теперь метод toString() всегда печатает свежее значение value.

Обновились до selenium-java 2.53.0

Список изменений в selenium 2.53.0.

Новости

Исторический момент: Selenide упомянут в Wikipedia
Radio QA - Выпуск 20: Лучше Selenide в руках, чем Selenium в небе
Презентация Якова Крамаренко на конференции SeleniumCamp 2016: Selenide Alternative in Practice
Рецепты Selenide: Appium + Selenide
Пост про автоматизацию полиграфического предприятия Ardecs: Selenide предлагает не заморачиваться
Статья про Selenide в Software testing magazine
Статья про Selenide от португальца Fabricio Galdino: API Selenide: Developing Functional Tests in Java

Немного статистики

Статистика скачиваний Selenide за февраль 2016:

И количество уникальных IP:

Нас всё больше!

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

А что у вас новенького?

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

ru.selenide.org

Вышла Selenide 3.3

2016-02-11T00:00:00+00:00

Привет!

Вышла в свет Selenide 3.3 с поддержкой коллекций. А именно,

Улучшена поддержка аякс для коллекций

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

См. issue #277

Добавился отдельный таймаут для коллекций

Мы добавили два новых параметра для коллекций:

collectionsTimeout (по умолчанию 6 секунд)
collectionsPollingInterval (по умолчанию 0.2 секунды)

Это связано с тем, что в большинстве случаев коллекции грузятся дольше, чем одиночные элементы (ведь в них больше элементов). Поэтому им требуется больший таймаут.

Обновились до selenium-java 2.51.0

Список изменений в selenium 2.51.0.

Новости

Лаконичный PageObject с GroovyPage + Selenide от Сергея Пирогова
Эффективные UI-тесты на Selenide на хабре
Статья про Selenide на КОРЕЙСКОМ!
Статья про Selenide на португальском
Selenide cheat sheet
Рецепты Selenide
Radio QA - Выпуск 16: Старый код борозды не испортит?
Новый классный формат - IT Battle. Батл 1: Почему нужно отказаться от автоматизации тестирования
Видео из девклуба: Никита Макаров — Микросервисы для автоматизации тестирования («Одноклассники»)

Давайте общаться!

У нас появились возможности более тесно общаться и обсуждать новые возможности и старые проблемы Selenide. Заходите!

А что у вас новенького?

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

ru.selenide.org

Вышла Selenide 3.2

2016-01-29T00:00:00+00:00

Привет!

Вышел в свет Selenide 3.2 - давайте знакомится!

Теперь Selenide пишет в логе версию браузера

Добавили INFO лог с версией браузера, Selenium и Selenide:

32:45 INFO BrowserName=chrome Version=48.0.2564.109 Platform=MAC
32:45 INFO Selenide v. 3.2
32:45 INFO Selenium WebDriver v. 2.51.0 build time: 2016-02-05 11:20:57

Улучшен отчёт

Мы переименовали FAILED->FAIL, PASSED->PASS в отчёте тестов, чтобы не путать с PASSED и FAILED, которые обычно пишут Maven и другие тулы. Теперь отчёт Selenide чуть проще анализировать в Jenkins.

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

Раньше можно было выбирать опцию из выпадающего списка по тексту или значению:

    $("select#email").selectOption("@yandex.ru");
    $("select#email").selectOptionByValue("98347643");

А теперь можно выбрать и по индексу:

    $("select#email").selectOption(4);

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

Добавлена новая настройка `selenide.browser-size`

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

java -Dselenide.browser-size=1024x768

или прямо в коде:

@Before
public void setUp() {
  Configuration.browser = "chrome";
  Configuration.browserSize = "1024x768";
}

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

Обновились до selenium-java 2.50.0

Список изменений в selenium 2.50.0.

До скорых встреч! Selenide 3.3 уже на подходе!

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

ru.selenide.org

Вышла Selenide 3.1

2016-01-17T00:00:00+00:00

Привет!

Год обещает быть плодотворным. Не успела страна очнуться после каникул, а мы уже выпустили Selenide 3.1. Посмотрим, что новенького?

Мы обновили документацию

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

Спасибо Алексею Виноградову и Эрику Халимову за проделанную работу!

Метод `$().download()` не любит невидимые ссылки

Раньше метод $().download() (по недосмотру) позволял скачивать файлы и с невидимых ссылок. Теперь мы эту оплошность ликвидировали. Спасибо @dimand58 за pull request.

Методы `switchTo(...)` теперь умеют ждать

Теперь методы switchTo(alert()), switchTo(frame()), switchTo(window()) стали умнее и умеют чуть-чуть подождать, если алерт, фрейм или окно ещё не загрузилось. Как обычно, по умолчанию таймаут 4 секунды.

Добавлены методы `byName`, `byXpath`, `byLinkText`, `byPartialLinkText`, `byId`

Это новые статические методы в классе Selectors (там же, где до этого были byText и withText). Фактически они дублируют селениумовские методы By.*. Не уверен, что они нужны, но некоторым нравится идея вообще не использовать никаких классов Selenium в своих тестах. И ещё это было полезно для того, чтобы использовать Selenide в тестах на .NET (чудны дела твои, господи!)

Багфикс: условие `$.shouldHave(exactTextCaseSensitive("..."))` теперь проверяет полную строку

А раньше (по недосмотру) проверял только подстроку.

Методы `$(WebElement, selector)` и `$$(WebElement, selector)` помечены как устаревшие

Вместо них лучше использовать метод find:

$(WebElement).find(selector)
$$(WebElement).find(selector)

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

На самом деле это просто синоним для $.val().

Selenide включает phantomjsdriver 1.2.1 из коробки

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

Обновились до selenium-java 2.49.0

Список изменений в selenium 2.49.0.

До скорых встреч! Selenide 3.2 и 3.3 уже на подходе!

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

ru.selenide.org

Вышла Selenide 3.0

2015-11-30T00:00:00+00:00

Привет!

Наконец-то мы выпустили Selenide 3.0. Уффф. Свершилось.

Внимание, версия 3.0 - это полный апгрейдец, то есть кое-что может перестать работать.

Не пугайтесь, если вы использовали только публичный API и не использовали @Deprecated методы, то для вас ничего не изменится. А если лезли в кишки, то читайте внимательно.

Исторический экскурс

Версия Selenide 1.0 была создана в 2011 году в казематах Codeborne и широко не рекламировалась. Примерно год Selenide мариновался и зрел. Мы пробовали использовать его в разных проектах - на Java, Scala, Groovy. Каждый раз обнаруживали, что API опять неудобен и требует доработок. :)

Наконец, в марте 2013 мы поехали в Киев на конференцию SeleniumCamp и к этому событию выпустили версию Selenide 2.0. В ней мы повыкидывали весь хлам и оставили только новый API. Этот момент можно считать днём рождения “публичной” версии Selenide. На тот момент в классе SelenideElement было всего-то с десяток методов. Кстати, сначала он назывался ShouldableWebElement. :)

С этого момента вышло 25 версий Selenide, в ней появилось множество новых функций и своё legacy, свои @Deprecated методы. Назрели перемены.

Поэтому наконец мы собрались с силами и выпустили Selenide 3.0

Новые функции в Selenide 3.0

Функция всего одна - метод Selenide.updateHash(). Она полезна при тестировании аяксовских приложений, которые реагируют на изменение “#” в URL. Метод updateHash() меняет “#bla-bla” в URL, не перезагружая всю страницу. Пример использования здесь.

Спасибо @fabienbancharel за pull request #254

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

обновились до Sizzle 2.2.1
обновились до Guava 19.0
обновились до TestNG 6.9.10

Опять же, это касается только тех, кто использует соответствующие функции и библиотеки.

Большой рефакторинг

Мы нещадно порефакторили класс AbstractSelenideElement. Теперь вместо одного большого класса у нас будет много маленьких классов (в пакете com.codeborne.com.commands), отвечающих каждый за свою задачу.
Вы можете легко переопределять любой из методов SelenideElement.
И вы даже можете добавлять свои методы в дополнение к стандартным методам Selenide и Selenium.

Подробнее об этом будет отдельный пост, но пример можно подсмотреть в тестах самого Selenide.

Спасибо Якову Крамаренко за идеи и ночные дискуссии.

Большая чистка

Как мы предупреждали в предыдущем анонсе, мы подчистили старый хлам. А именно:

Удалили устаревшие условия:
- notPresent -> используйте $.shouldNot(exist) или $.shouldNotBe(present).
- hasOptions -> Используйте $.selectOption() или $.selectOptionByValue().
- options -> Используйте $.selectOption() или $.selectOptionByValue().
- hasNotClass -> Используйте $.shouldNotHave(cssClass("abc"))
Удалили класс JQuery
Удалили класс PrettyReportCreator (используйте TextReport для JUnit или TestNG)
Удалили устаревшие методы
- Selenide.switchToWindow(title) -> используйте switchTo().window(title)
- Selenide.switchToWindow(index) -> используйте switchTo().window(index)
Удалили устаревшие методы
- WebDriverRunner.ie() -> используйте WebDriverRunner.isIE()
- WebDriverRunner.htmlUnit() -> используйте WebDriverRunner.isHtmlUnit()
- WebDriverRunner.phantomjs() -> используйте WebDriverRunner.isPhantomjs()
- WebDriverRunner.takeScreenShot() -> используйте Screenshots.takeScreenShot()
Удалили устаревшие методы
- $.should*(String message, Condition condition) -> используйте $.should*(condition.because(message))
Удалили класс class com.codeborne.selenide.impl.Quotes, потому что он переехал в Selenium Webdriver (теперь это org.openqa.selenium.support.ui.Quotes)

Смело обращайтесь, если у вас всё-таки что-то сломалось.

Будем вместе решать, где исправлять! Мы к этому готовы.

Новости

Selenide попала в список Лучшие инструменты и сайты про Java 2015
Статья про Selenide в рождественском календаре Java Effective UI tests with Selenide
Статья про Selenide на японском языке. На японском, Карл! (chrome -> translate в помощь)
15ый выпуск подкаста Radio QA Работаем за идею или за деньги?. Говорят, было жарко.
Русскоязычный чат тестировщиков на слаке softwaretesters

Ну и с наступающим вас!

Быстрых и эффективных тестов! Пусть селекторы селектяцца, сервисы мочацца, базы данных инмеморяцца, а разработчики юнит-тестяцца.

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

ru.selenide.org

Изменения в Selenide 2.25

2015-11-30T00:00:00+00:00

Привет!

Мы выпустили Selenide 2.25. Это последняя версия в линейке 2.*, даже будет большой рефакторинг, чистка deprecated и релиз Selenide 3.0.

Пожалуйста, пробегитесь по своим тестам и убедитесь, что вы не используете @Deprecated методы. Мы планируем их удалить в Selenide 3.0.

А пока - новинки в Selenide 2.25:

Добавили “Профайлер Selenide” для TestNG

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

Кстати, мы переименовали его в TextReport.

Чтобы включить профайлер в JUnit:

  @Rule
  public TestRule report = new TextReport();

Чтобы включить профайлер в TestNG:

  @Listeners(TextReport.class)
  public class GoogleTestNGTest {
    ...
  }

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

Они позволяют легко получить первый и последний элементы коллекции:

  $$("#employees .fired").first().shouldHave(text("Steve Jobs"));
  $$("#employees .fired").last().shouldHave(text("Richard Williamson"));

Добавили метод `Screenshots.getLastScreenshot()`

Этот метод возвращает последний скриншот, снятый Selenide. Он будет полезен тем, кто хочет интегрировать Selenide с какими-то фреймворками для построения отчётов, такими как Allure.

Кстати, мы переименовали метод getScreenShotAsFile() в takeScreenShotAsFile(), потому что старое название было обманчивым: этот метод снимает скриншот, а не просто возвращает.

Добавили метод `Selenide.confirm()` и `Selenide.dismiss()` без параметров

До сих пор в Selenide были методы confirm(String) и dismiss(String) с параметром - ожидаемым текстом диалога:

  confirm("Вы точно уверены, что хотите удалить файл?");
  dismiss("Вы точно уверены, что хотите удалить файл?");

Эти методы нажимают “ok” или “cancel” в модальном диалоге “confirm” и проверяют, что текст был правильным.

Но иногда вы не хотите проверять текст. Поэтому мы добавили методы confirm() и dismiss() без параметров:

  String text = confirm();
  String text = dismiss();

они не проверяют, но возвращают текст диалогового окна.

Добавили параметр `-Dselenide.reopenBrowserOnFail`

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

В этом случае просто используйте новую настройку: -Dselenide.reopenBrowserOnFail=false

Обновились до htmlunit 2.19

Многие считают браузер HtmlUnit умершим, а нам он нравится. По крайней мере, тесты самого Selenide на нём стабильно бегают.

Поменяли лицензию Selenide на MIT

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

Новости

На популярном портале automated-testing.info появился специальный раздел, посвящённый Selenide
Презентация Selenide на Devoxx 2015 - крупнейшей Java-конференции Европы
Скринкаст Якова Крамаренко о тест-покрытии и Selenide - пробный прогон для конференции SQA Days 2015
13ый выпуск подкаста Radio QA Как натестировать на iPhone
14ый выпуск подкаста Radio QA QA: Пациент жив или мертв?

А что у вас новенького?

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

ru.selenide.org

Selenide меняет лицензию на MIT

2015-11-16T00:00:00+00:00

Привет!

Мы долго сомневались, но всё-таки поменяли лицензию Selenide на MIT.

Если вкратце, это значит, что с исходным кодом Selenide можно делать всё, что угодно.

MIT - наиболее свободная лицензия.

Вот тут есть иллюстративное сравнение опен-сорсных лицензий MIT, Apache и GPL.

Чем не устраивал LGPL?

Вообще-то LGPL нас устраивал. Лицензия LGPL обязывает вас выкладывать свой код в опен-сорс, если вы включаете код Selenide в свой продукт. Но поскольку вы используете Selenide только в своих тестах, то вы не включаете Selenide в свой продукт, который вы доставляете пользователям. Следовательно, вы не обязаны выкладывать свой код в опен-сорс.

Почему мы поменяли лицензию?

Оказалось, что многие компании просто боятся GPL. Они не хотят связываться с GPL в принципе, не разбираясь в нюансах. Поэтому мы решили поменять лицензию Selenide на самую свободную и ни к чему не обязывающую - MIT.

Если у вас есть знакомые, не использующие Selenide из-за лицензии - сегодня у вас есть для них хорошие новости! :)

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

ru.selenide.org

Презентация Selenide на Devoxx 2015

2015-11-13T00:00:00+00:00

Теперь - и в Европе!

Эта неделя ознаменовалась громким событием в Java-мире - конференцией Devoxx, крупнейшей в Европе.

Я сделал доклад про Selenide на этой конференции. И эти ребята уже выложили видео - они просто нереально быстрые:

А тут слайды:

А вот тут есть видео остальных докладов Devoxx 2015.

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

ru.selenide.org

Изменения в Selenide 2.24

2015-11-08T00:00:00+00:00

Привет!

Вышел небольшой релиз Selenide 2.24. По сусекам поскребли, по амбару намели.

Обновились до selenium-java 2.48.2

Список изменений в selenium 2.48.2.

Новый метод `$.pressEscape()`

В дополнение к методам

$("input").pressEnter();
$("input").pressTab();

Появился новый метод:

$("input").pressEscape();

Исправили работу мягких ассертов в TestNG

Возможно, вы не знали, но в Selenide есть мягкие ассерты (soft asserts). В какой-то версии они оказались сломанными, если запускать тесты на TestNG. Теперь починились.

Логику для создания вебдрайвера выделили в отдельный класс WebDriverFactory

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

Новости

Конференция Devoxx.be
Я буду представлять Selenide на крупнейшей Java-конференции Европы Devoxx в Антверпене
Это же здорово, товарищи!
10ый выпуск подкаста Radio QA Стратегия тестирования
11ый выпуск подкаста Radio QA HR: НЯ или не НЯ
12ый выпуск подкаста Radio QA Обучи меня, если сможешь
Обзор конференции QAFest 2015

А что у вас новенького?

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

ru.selenide.org

Доклад о Selenide на SeleniumConf 2015

2015-09-23T00:00:00+00:00

Наконец-то!

У меня появился шанс представить Selenide на ежегодной конференции SeleniumConf, которая в этом году проходила в Портленде, США.

Вот видео моего доклада:

И слайды:

А здесь можно посмотреть видео других докладов с SeleniumConf.

Наслаждайтесь!

Andrei Solntsev

selenide.org

Изменения в Selenide 2.23

2015-09-15T00:00:00+00:00

Категорически приветствую!

Сентябрь ознаменовался выходом Selenide 2.23. Пробежимся по новинкам?

Новый метод `$.selectRadio()`

Чтобы выбрать кнопку radio, раньше можно было использовать метод

Selenide.selectRadio(By.name("gender"), "male");

Теперь появился новый метод, похожий на остальные методы Selenide:

$(By.name("gender")).selectRadio("male");

И в лучших традициях Selenide, этот метод умеет ждать, если элемент доступен не сразу.

Метод `$.setValue()` теперь понимает и кнопки radio

Мы стремимся делать Selenide максимально универсальным, так чтобы вам приходилось меньше думать о технических деталях веб-элементов. В частности, метод $.setValue() понимает, какому элементу вы пытаетесь присвоить значение: input, select или textarea, и действует соответственно.

Теперь к этому списку добавились и radio buttons.

Метод $.setValue() теперь умеет работать и с ними:

$(By.name("gender")).setValue("male");
$(By.name("gender")).val("male");

Нельзя менять значение в поле readonly

Теперь метод $.setValue() выкинет исключение, если вы попытаетесь вбить значение в поле с признаком readonly. Будьте внимательны, это потенциально может сломать некоторые из ваших тестов.

Метод `$.setValue()` теперь учитывает атрибут `maxlength`

Если вы пытаетесь вбить слишком длинный текст в элемент с атрибутом maxlength, Selenide обрежет значение. Будьте внимательны, и это тоже может сломать некоторые из ваших тестов.

Исправлена проблема с незакрывающимися браузерами FireFox

Некоторые пользователи продолжали жаловаться на незакрывающиеся браузеры.

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

Новости

Сегодня у нас потрясающие новости, позвольте поделиться!

Конференция SeleniumConf 2015

Ура, библиотека Selenide наконец-то была представлена на ежегодной конференции SeleniumConf, которая в этом году проходила в Портленде, США.
Вот видео и слайды моей презентации.

Кстати, остальные видео с SeleniumConf 2015 доступны здесь.
Исторический момент: вышла книга про Selenide! Точнее, книга называется Test-Driven Java Development, но примеры кода в ней используют именно Selenide в связке с JBehave и Cucumber.
Ну это же просто праздник какой-то!

9ой выпуск подкаста Radio QA День программиста
Эпичная заметка Сергея Пирогова Почему фразу “Мы будем писать свой тестовый фреймворк” нужно произносить шепотом
Доклад Андрея Стахиевича с конференции ComaQA.BY Page Object паттерн и Selenide
Доклад Антон Семенченко Appium+Selenide: Cross-Platform Mobile QA Automation
По следам конференции #socrates15: Ext JS 5 Tests with Selenide

Немного статистики

Статистика скачиваний Selenide за август:

Нас всё больше! И с сентябре будет ещё больше!

А что у вас новенького?

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

ru.selenide.org

Изменения в Selenide 2.21 и 2.22

2015-08-29T00:00:00+00:00

Доброй субботы!

Недавно мы зарелизили Selenide 2.21 и 2.22. Там были немногочисленные, но кардинальные изменения, о которых вам нужно знать.

Переход на Java 7

Начиная с версии 2.21, Selenide работает только на Java 7 или выше.

Если вы до сих пор работали на Java 6, пора обновляться - больше ждать невозможно!

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

Она-то и требует Java 7.
поддержка нативных событий только до FireFox 31, а для более новых FireFox есть только синтетические события.
Добавилась экспериментальная поддержка нового браузера “Microsoft Edge”

Список изменений 2.47.1

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

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

Спасибо за вашу помощь!

Спасибо всем, кто проголосовал. Ваши голоса помогли, и мою заявку приняли на конференцию SeleniumConf 2015. Еду 8 сентября в Портланд рассказывать про Selenide американской аудитории.

Новости

Хочу поделиться новостями

8ой выпуск подкаста Radio QA Про хихикритикалы
7ой выпуск подкаста Radio QA Инструменты тестировщика
Видео: Алексей Баранцев Aspiration Driven Development
Видео: Ирина Иванова Ловушки мышления в тестировании
Видео: Антон Кекс и Дмитрий Эсс Школа программирования Codeborne
Testing challenge

А что у вас новенького?

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

ru.selenide.org

Изменения в Selenide 2.20

2015-07-27T00:00:00+00:00

Здрасьте!

Сегодня мы зарелизили Selenide 2.20. Что новенького нас ждёт?

Защита от зависания вебдрайвера при открытии/закрытии браузера

Иногда при открытии или открытии браузера вебдрайвер зависает. Видимо, какие-то баги в вебдрайвере. Просто этот поток бесконечно висит в одном и том же состоянии: “Forwarding newSession on session null to remote”

Мы добавили защиту против этой проблемы. Теперь Selenide запускаете открытие/закрытие браузера в отдельном потоке и ждёт ограниченное время (не дольше 15 секунд при открытии и не 5 секунд при закрытии). При неудаче пробует снова (до 3 раз) и лишь потом вылетает с ошибкой.

Спасибо @admizh за это предложение!

См. Issue 199 и Issue 204

Логирование переведено на java.util.logging

До сих пор Selenide выводил свои сообщения через System.out и System.err

Вообще-то я думаю, что для тестов этого вполне достаточно: просто и надёжно. Но идя навстречу пожеланиям трудящихся, мы перевели логирование Selenide на “стандартный” механизм java.util.logging (JUL).

Честно говоря, log4j и slf4j явно лучше JUL, но JUL поставляется вместе с Java и используется в Selenium, так что нам не было смысла добавлять в Selenide ещё одну зависимость.

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

Jul 25, 2015 10:48:21 PM com.codeborne.selenide.impl.WebDriverThreadLocalContainer createDriver
INFO: Create webdriver: 1 -> FirefoxDriver: firefox on MAC (3e54e3de-b212-2a45-93ad-712aae6ee853)

Чтобы сделать логирование чуть удобнее (если у вас в проекте вдруг ещё не настроен JUL), можно добавить такую строчку в начало тестов:

System.setProperty("java.util.logging.SimpleFormatter.format", "%1$tT %4$s %5$s%6$s%n");

Или если вы предпочитаете slf4j, то добавьте зависимость org.slf4j:jul-to-slf4j:1.7.12 в проект и такую строчку в начало тестов:

SLF4JBridgeHandler.removeHandlersForRootLogger();
SLF4JBridgeHandler.install();

Теперь логи Selenide будут выглядеть так:

22:48:15 INFO  INFO: Create webdriver: 1 -> FirefoxDriver: firefox on MAC (3e54e3de-b212-2a45-93ad-712aae6ee853)

См. Issue 195

Исправили использование Cookies при скачивании файла

Спасибо @philipp-kolesnikov за этот pull request!

Добавили поддержку коллекций элементов в Page Objects

Теперь в своём пэдж обжекте можно объявить поле - список элементов:

public class SearchResultsPage {
  @FindBy(css = "#ires li.g")
  private ElementsCollection results;

См. Issue 186

Спасибо @rishaselfing за подсказку!

P.S. Хотя я по-прежнему думаю, что гораздо короче и проще писать пэдж обжекты без использования аннотаций:

public class SearchResultsPage {
  private ElementsCollection results = $$("#ires li.g");

Метод $(“select”).shouldHave(text(“…”)) теперь проверяет выбранную опцию

Раньше метод $("select").shouldHave(text("...")) фактически был бесполезным, т.к. учитывал тексты всех <option>, а не только выбранных. Теперь же он проверяет только текст выбранных элементов. А также метод $("select").getText() возвращает только текст выбранных опций.

См. Issue 134

Добавили возможность снять скриншот отдельного элемента или региона

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

Вот так легко её можно использовать в своих тестах:

    File screenshot = $("#some-div").screenshot();

См. Issue 66

Все методы `$(String, ...)` теперь deprecated

Пожалуйста, убедитесь в том, что вы не используйте deprecated методы. Мы собираемся их удалить в одной из следующих версий Selenide (вероятно, 3.0).

Теперь добавить объяснение к проверкам можно с помощью функции because:

$("h1").shouldHave(text("Some wrong test").because("it's wrong text"));
$("h1").waitUntil(hidden.because("it's sensitive information"), 100);

Удалили зависимость cglib-nodep из зависимостей Selenide

Мы обнаружили, что зависимость cglib-nodep старая и ненужная, и иногда она может создавать конфликты с зависимостями в текущих проектах. К тому же она, кажется, не поддерживает Java 8 и уже лет 5 как не развивается.

Если вам всё же по каким-то причинам нужна cglib-nodep, просто добавьте эту зависимость в проект: cglib:cglib-nodep:jar:3.1

Мне нужна ваша помощь!

Проголосуйте з амою заявку Selenide на конференцию SeleniumConf 2015 здесь!

Новости

Хочу поделиться новостями

Слушайте новый подкаст про тестирование Radio QA
Читайте гениальные презентации про тестирование от Капитана Хаоса: Смертные грехи и постыдные слабости автоматизаторов
Посмотрите, как скрестить Appium и Selenide для тестирования мобильных приложений.
И улыбайтесь, господа: Developer tools непонятный

А что у вас новенького?

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

ru.selenide.org

Изменения в Selenide 2.19

2015-06-21T00:00:00+00:00

Категорически приветствую!

Вышел Selenide 2.19.

Исправлено несколько мелких проблем, в основном касающихся работы с фреймами и борьбой с самоподписанными сертификатами.

Работа с вложенными фреймами

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

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

В Selenide 2.19 мы добавили удобный метод для переключения сразу в нужный вложенный фрейм одной командой:

  import static com.codeborne.selenide.Selenide.*;
  
  switchTo().innerFrame("parentFrame", "childFrame_2", "childFrame_2_1");

Кстати, поиск фрейма ещё и работает быстрее, чем в Selenium, из-за более оптимального использования селекторов.

Спасибо @dimand58 за этот pull request!

PhantomJS теперь умеет работать с самоподписанными сертификатами

Ещё одна находка дьявола - это самоподписанные сертификаты. Это когда администраторы в вашей конторе очень хотят секьюрити и поэтому запускают тестовое приложение на https (типа https://test.company.ru), но на настоящий SSL сертификат деньги жмотят, и поэтому используют в тесте SSL сертификат, который сами же и подписали. В итоге секьюрити никакой не получается, а бедные тестировщики-автоматизаторы получают себе вечный геморрой “браузер плюётся ворнингами”, “файлы не качаются”, “в IE сайт не открывается”. Дьявол довольно потирает копытца.

Производители вебдрайверов тоже подкидывают углей в топку. Ведь есть же стандартная настройка "acceptSslCerts", которую понимают Chrome, FF и даже htmlunit. Так нет же, PhantomJS её не понимает, требует какую-то свою настройку! А IE так вообще не понимает никаких настроек.

В общем, мы докрутили что надо, теперь PhantomJS открывает “https://test.company.ru” без ругательств.

С IE пока всё глухо. Кто знает рецепт, поделитесь.

Метод `$.download()` больше не ругается на самоподписанные сертификаты

Если кто не знал, в Selenide есть аццки удобный метод для скачивания файлов:

File cv = $("#cv").download();

Теперь и он не ругается при попытке скачать файл с “https://test.company.ru”.

Метод `$.setValue()` также генерирует событие “focus”

Раньше метод $.setValue() (в режиме fastSetValue=true) генерировал события “keydown”, “keypress”, “input”, “keyup”, “change”. Теперь добавилось ещё “focus”. Я на самом деле не уверен, нужно ли это. Сделал на всякий случай.

Исправили багу со скриншотами из Selenide 2.18

В Selenide 2.18 появилась одна забавная бага: Selenide начал делать слишком много скриншотов. Даже когда тесты не падали. Это не вызывало падения тестов, просто занимало больше место на диске.

Обновились до Selenium Webdriver 2.46.0

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

Появилась бета-версия вебдрайвера Marionette (какой-то новый замут с Firefox)
В каких-то случаях обещали 10-кратное ускорение старта селениум сервера
Смерть нативных событий в Firefox 33+
Смерть старой Оперы (Presto-based)
Ну и много всего другого

А что у вас новенького?

Изменения в Selenide 2.18

2015-05-06T00:00:00+00:00

Здрасьте!

В конце апреля мы наконец-то выпустили Selenide 2.18. Это был непростой релиз. Мы полностью переписали алгоритм умных ожиданий, так что теперь-то уж наверняка он отлавливает все StaleElementException.

Давайте я расскажу всё подробно.

Механизм ожиданий

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

В Selenide 2.18 мы переписали механизм ожиданий, так что теперь StaleElementException стал почти совсем невозможен.

Раньше механизм был такой:

подождатьЭлемент().click()

Selenide сначала ждал, пока элемент станет видимым, а потом делал с ним необходимое действие. То есть действие с элементом было “двухфазным”. И иногда (особенно в SPA-приложениях) могло случиться, что первая фаза отработала корректно, то есть элемент был виден на экране, а во время второй фазы (в данном примере click) элемент пропадал.

Теперь алгоритм стал таким:

  пока (ошибки и <4 секунд) {
    элемент.click()
  }

Такой алгоритм, во-первых, чуть быстрее, потому что для большинства элементов (которые не пропадают и не появляются) он делает всего одно действие вместо двух. А во-вторых, вероятность получить StaleElementException тут меньше. Хотя, увы, всё ещё ненулевая. :(

Скриншоты

Теперь Selenide делает скриншоты после любых ошибок. А раньше он не делал скриншоты, например, в случае селениумовских ошибок (скажем, если метод click() ругнулся, что элемент некликабельный).

Метод `$.shouldHave(value("john"))` игнорирует невидимые символы (пробелы, табуляции, переводы строк).

Это полезно, чтобы тесты не валились из-за того, что в тестовых данных число отформатировано с пробелом, а на страничке символом nbsp (non-breakable space). Визуально разницы нет, пользователь ничего не заметит - значит, и тест не должен делать различий.

А если вам всё-таки очень проверить точное значение, мы добавили специальную проверку $.shouldHave(exactValue(" john ")).

Режим кликов через JavaScript

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

Включить новый режим можно через свойство -Dselenide.click-via-js=true

Спасибо @dimand58 за этот pull request!

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

Например:

  $(".modal-popup").doubleClick();`

Методы `$.hover()`, `$.contextClick()`, `$.dragAndDropTo()` теперь можно чейнить

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

  $("#username").hover().contextClick().doubleClick();

Исправлена работа Sizzle селекторов на страничках без jQuery

Спасибо @Gert за этот pull request!

Добавлен метод `WebDriverRunner.hasWebDriverStarted()`

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

Спасибо @dimand58 за этот pull request!

Метод `$.setValue()` в режиме `fastSetValue` теперь генерирует событие `input`

Теперь $.setValue() в режиме fastSetValue генерирует следующую последовательность событий:

keydown
keypress
input
keyup
change

Это исправило автозаполнение в некоторых приложениях, а также заполнение textarea. Надеюсь, теперь $.sendKeys() можно заменить на быстрый метод $.setValue() практически везде.

А у вас получилось?

Теперь Selenide зависит от более последней версии commons-codec 1.10

Раньше Selenide подгружал (транзитивно от selenium-java) старую версию библиотеки commons-codec 1.6 Это могло создавало трудности для приложений, которые хотят использовать более новую commons-codec.

Разрешите похвастаться

И на десерт - апрельская статистика скачиваний Selenide из центрального репозитория. Нас становится всё больше!

Количество уникальных IP:

И количество непосредственно скачиваний:

А что у вас новенького?

Изменения в Selenide 2.16 и 2.17

2015-05-05T00:00:00+00:00

Здрасьте!

Мы долго не писали в блог. За это время вышло аж три версии Selenide. Сегодня расскажу про изменениях в версиях 2.16 и 2.17

Soft asserts

Мы наконец-то добавили SoftAsserts в Selenide. Я до сих пор не уверен, что это хорошая идея, но уж очень много просили. :)

По сути, режим SoftAssert означает, что все проверки типа $.shouldHave(text("xxx")) будут валиться не сразу, а только в конце теста. Это позволяет разом накопить все фейлы, разом их исправить и один раз перезапустить тест. Наверное, это удобно, если каждый запуск тестов обходится вам слишком дорого.

Чтобы включить Soft asserts в JUnit (см. документацию):

public class SoftAssertJUnitTest {
  @Rule public SoftAsserts softAsserts = new SoftAsserts();

Чтобы включить Soft asserts в TestNG (см. документацию):

@Listeners(SoftAsserts.class)
public class SoftAssertTestNGTest {

И как выглядит результат.

После запуска всего теста в конце выплёвываются разом все накопившиеся ошибки:

java.lang.AssertionError: Test userCanUseSoftAssertWithJUnit(integration.SoftAssertJUnitTest) failed.
3 checks failed

FAIL #1: Element should have attribute value=777 {#radioButtons input}
Element: '<input name="me" type="radio" value="master"></input>'
Screenshot: file:/Users/andrei/projects/selenide/build/reports/tests/integration/SoftAssertJUnitTest/userCanUseSoftAssertWithJUnit/1425503251321.0.png
Timeout: 0 ms.

FAIL #2: Element not found {#radioButtons select}
Expected: visible
Screenshot: file:/Users/andrei/projects/selenide/build/reports/tests/integration/SoftAssertJUnitTest/userCanUseSoftAssertWithJUnit/1425503252361.1.png
Timeout: 0 ms.
Caused by: NoSuchElementException: Unable to locate element: {"method":"css selector","selector":"#radioButtons select"}

FAIL #3: Element not found {#xxx}
Expected: visible
Screenshot: file:/Users/andrei/projects/selenide/build/reports/tests/integration/SoftAssertJUnitTest/userCanUseSoftAssertWithJUnit/1425503252697.2.png
Timeout: 0 ms.
Caused by: NoSuchElementException: Unable to locate element: {"method":"css selector","selector":"#xxx"}

    at org.junit.Assert.fail(Assert.java:88)
    at com.codeborne.selenide.junit.SoftAsserts.after(SoftAsserts.java:54)
    at org.junit.rules.ExternalResource$1.evaluate(ExternalResource.java:50)
        ....
    at com.intellij.rt.execution.application.AppMain.main(AppMain.java:134)

Профайлер

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

Пример отчёта:

+--------------------+--------------------------------------------+----------+----------+
|Element             |Subject                                     |Status    |ms.       |
+--------------------+--------------------------------------------+----------+----------+
|open                |http://0.0.0.0:23762/page_jquery.html       |PASSED    |131       |
|#multirowTable      |find elements(by text: Chack)               |PASSED    |100       |
|#multirowTable tr   |find elements(by text: Chack)               |PASSED    |100       |
|#multirowTable tr   |find(by text: Chack)                        |PASSED    |0         |
|by text: Chack      |get attribute(class)                        |PASSED    |139       |
+--------------------+--------------------------------------------+----------+----------+

Чтобы включить этот отчёт, нужно добавить такое правило в ваши тесты:

@Rule
public TestRule prettyReportCreator = new PrettyReportCreator();

Эта функциональность экспериментальная, пока поддерживается только JUnit.

Попробуете - расскажите, как получилось.

Спасибо kumarunster за этот pull request!

Исправлена функция `$.closest()`

Теперь поиск родительского элемента по классу работает корректно:

  $(By.name("firstName")).closest(".active");

Метод `$.toString()` теперь логирует все атрибуты

Раньше метод логировал только несколько конкретных атрибутов: id, class, type и т.д. Проблема в том, что Selenium webdriver не предоставляет метода для получения всех атрибутов.

Но мы нашли способ! Теперь метод $.toString(), используя хитрый JavaScript, достаёт все атрибуты:

      assertEquals("<div class=\"invisible-with-multiple-attributes\" " +
          "data-animal-id=\"111\" id=\"gopher\" ng-class=\"widget\" ng-click=\"none\" " +
          "onchange=\"console.log(this);\" onclick=\"void(0);\" placeholder=\"Животное\" " +
          "displayed:false></div>", $("#gopher").toString());

Обновились до Selenium 2.45.0.

Внимание, с этим релизом отключились нативные события в Firefox.

Только не спрашивайте: “И чо?” Я и сам хотел бы знать - и чо?

А что у вас новенького?

Как тестировать GMail

2014-12-28T00:00:00+00:00

Привет!

Вы когда-нибудь задумывались, а как бы вы стали тестировать GMail, если б были разработчиком Google? Это отличное упражнение для тестировщика, непременно попробуйте!

Тестирование GMail нетривиально, т.к. в нём на каждый чих используется Ajax, грузится долго, всё генерируется динамически и нет разумных селекторов/айдишек. Замучаешься везде проставлять wait!

Проект GMail test

Но счастье возможно! В серии Selenide Examples мы представляем проект на гитхабе, в котором написан тест для GMail. Он проверяет содержимое инбокса и пишет новое письмо. Причём ещё и делает “Undo”, редактирует и снова посылает. И в конце ждёт, пока кнопка “Undo” пропадёт.

Видео

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

Вскрытие покажет

Вот сам проект на гитхабе: https://github.com/selenide-examples/gmail

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

Настройка

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

  @BeforeClass
  public static void openInbox() {
    timeout = 10000;
    baseUrl = "http://gmail.com";
    
    open("/");
    $(byText("Loading")).should(disappear);
    login();
  }

Обратили внимание, как мы ждём окончания загрузки страницы? В этом вся мощь Selenide: элемент легко найти по тексту, и легко дождаться, пока он пропадёт.

Логин

Логин происходит очень просто:

  private static void login() {
    $("#Email").val(System.getProperty("gmail.username", "enter-your-gmail-username"));
    $("#Passwd").val(System.getProperty("gmail.password", "enter-your-gmail-password"));
    $("#signIn").click();
    $(".error-msg").waitUntil(disappears, 2000);
  }

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

Количество непрочитанных писем

В реальной жизни я бы запускал тесты с определённым набором тестовых данных со, скажем, 4 непрочитанными письмами. И тогда я бы в тесте проверил наличие надписи “Inbox (4)”:

  @Test
  public void showsNumberOfUnreadMessages() {
    $(By.xpath("//div[@role='navigation']")).find(withText("Inbox (4)")).shouldBe(visible);
  }

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

Проверка содержимого инбокса

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

  @Test
  public void inboxShowsUnreadMessages() {
    $$(byText("Gmail Team")).filter(visible).shouldHave(size(1));
    $$(byText("LastPass")).filter(visible).shouldHave(size(3));
    $$(byText("Pivotal Tracker")).filter(visible).shouldHave(size(3));
  }

Обновление инбокса

В интерфейсе GMail есть кнопка обновления “Refresh”. Ищем её по атрибуту title=Refresh - другого способа я не нашёл.

  @Test
  public void userCanRefreshMessages() {
    // В реальной жизни: INSERT INTO messages ...
    $(by("title", "Refresh")).click();
    // В реальной жизни: проверить, что новое письмо появилось в инбоксе
  }

В настоящих тестах я до нажатия добавил бы новое письмо в базу данных, и после нажатия “Refresh” проверил бы, что оно появилось в инбоксе.

Новое письмо

Для составления нового письма нажимаем кнопку “COMPOSE”:

    $(byText("COMPOSE")).click();

И вбиваем адрес, тему и текст:

    $(By.name("to")).val("andrei.solntsev@gmail.com").pressTab();
    $(by("placeholder", "Subject")).val("ConfetQA demo!").pressTab();

    $(".editable").val("Hello braza!").pressEnter();
    $(byText("Send")).click();

В общем-то, совсем ничего сложного.

И в конце проверяем, что письмо отправилось:

    $(withText("Your message has been sent.")).shouldBe(visible);

Undo - redo

В моём почтовом ящике включена экспериментальная фича - “Undo”. После отсылки письма в течение 10 секунд горит кнопка “Undo”, нажав на которую, я могу отменить отсылку последнего письма и вернуться к редактированию. Очень удобно, когда, нажав “Send”, обнаруживаешь, что случайно послал письмо не тому человеку.

Итак, попробуем это протестировать. В конце предыдущего теста добавляем:

    $(byText("Undo")).click();
    highlight($(byText("Sending has been undone.")).should(appear));

Подправляем текст письма:

    $(".editable").should(appear).append("Hello from ConfetQA Selen").pressEnter().pressEnter();

    $(byText("Send")).click();

И ждём 10 секунд, пока кнопка “Undo” пропадёт:

    highlight($(withText("Your message has been sent.")).should(appear));
    highlight($(byText("Undo")).should(appear)).waitUntil(disappears, 12000);
    $(byText("Sent Mail")).click();

Письмо окончательно отослано адресату.

Вот теперь GMail протестирован, гугл может спать спокойно.

Выводы

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

Поиск элементов по тексту.
Это максимально приближено к поведению пользователя и минимально зависит от реализации веб-приложения.
Тестировать только важное
В приложении GMail ещё куча вещей осталась непротестированными. В данных условиях их, кажется, и невозможно протестировать (невозможность подсунуть тестовые данные, отсутствие статических локаторов). Но это не так уж и важно - главное, что критичные функции мы протестировали: показ писем в инбоксе и отсылка нового письма. Всегда начинайте с тестирования критичной функциональности, а остальное успеете оценить позже.
Используйте правильные инструменты
Selenide автоматически решает проблемы с таймаутами, аяксом, динамическим контентом, поиском по тексту. Тесты не загрязнены длинными страшными XPath. Тесты содержат только логику. Тесты хорошо читаемые.

Простых вам тестов!

Андрей Солнцев
ru.selenide.org

Где взять время на рефакторинг

2014-12-17T00:00:00+00:00

Один из самых животрепещущих вопросов начинающих идеалистов - где взять время на рефакторинг?

Он возникает и у разработчиков, и у тестировщиков. И у тех, и у других очень быстро возникает куча грязного кода и куча запутанных, медленных, нечитаемых тестов. Жить с ними всё сложнее. Разработка/тестирование всё замедляется, мотивация всё падает. Иногда удаётся что-то подчистить в нерабочее время, но… это же не по-человечески?

Где справедливость?
Это что, мне одному надо?
Почему начальство не даёт времени на рефакторинг?

Я знаю. Я тоже через это прошёл.

А нигде!

А теперь взглянем правде в глаза. Если кто-то придёт ко мне и попросит неделю на рефакторинг, я ему откажу.

И вот почему. Потому, что рефакторить можно бесконечно, а кто-то должен и работу делать.

10 лет назад мне было обидно такое слышать. Теперь я сам это говорю. Более того, я говорю, что исправлять код по ночам - это не несправедливо, это - непрофессионально.

Так что же, я разуверился в своих идеалах?

Вовсе нет.

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

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

Вот мой рецепт:

Маленькими шагами!

Вспомните TDD. Ваш рабочий процесс должен выглядеть буквально так:

Написал тест (красный) - 1 час
Написал код (чтобы тест позеленел) - 1 час
Зарефакторил код (чтобы код стал проще и читаемее) - 1 час
Налил чаю, вернулся к шагу 1.

Это постоянный процесс. Маленькие шаги. Постоянный прогресс. Горячий чай.

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

А как начальство на это посмотрит?

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

Никого и никогда ещё не уволили за то, что он делал очередную фичу 6 часов, а не 5.

Вдумайтесь, на самом деле начальство ведь не знает, сколько её надо делать. Стало быть, никто никогда не сможет вам доказательно предъявить, что вы зря потратили время на написание тестов или рефакторинг. Да, вы не можете доказать, что рефакторинг ускоряет процесс разработки. Но и начальство не может доказать обратное. Стало быть - делайте так, как считаете нужным.

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

Маленькие шаги: Тест. Код. Рефакторинг.

И что, даже разрешения не надо спрашивать?

Если кто-то придёт ко мне и попросит неделю на рефакторинг, я ему откажу - по той простой причине, что он не знает мантру TDD. Он почти наверняка профигакторит эту неделю, но лучше ничего не станет.

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

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

Маленькие шаги. Постоянный прогресс. Чай с имбирём.

И печенькой.

The fast and the continuous @ SQA Days 16

2014-12-13T00:00:00+00:00

Видео моего доклада “The fast and the continuous” на недавней конференции SQA Days 16 в Санкт-Петербурге.

Вы всё ещё гоняете все свои тесты на Selenium?

Вы всё ещё считаете, что TestNG круче, чем JUnit?

Вы всё ещё пытаетесь распараллелить свои тесты?

Вы всё ещё мечтаете иметь собственный Selenium Grid с 30 машинами и прогонять тесты всего лишь за пару часов?

Тогда мы идём к вам!

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

Тестирование - это не должно быть сложно!

The fast and the continuous from Vlad Orlikov on Vimeo.

Видео доклада Андрея Солнцева на SQA Days-16
14-15 ноября 2014, Санкт-Петербург, Россия
www.sqadays.com

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

Антитроллинг

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

Пирамида тестирования

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

Зачем провокации

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

Приятного просмотра, и
смелее делитесь мнениями, хорошими и разными.

Вы находите не те ошибки

2014-12-09T00:00:00+00:00

На недавней конференции SQA Days в Санкт-Петербурге произошёл один инцидент, который поначалу остался незамеченным. Я не нашёлся сразу, что ответить, лишь улыбнулся в ответ. Но какое-то зерно сомнения проронилось в мой мозг и проросло лишь через несколько дней.

В общем,

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

Вы находите не те ошибки.

Я лишь улыбнулся.

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

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

МЫ ВООБЩЕ НЕ ИЩЕМ ОШИБКИ.

Что такое Quality Assurance

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

QA расшифровывается как “Quality Assurance”, то есть - “уверенность в качестве”. Наша первоочерёдная задача не найти все баги. Наша первоочерёдная задача - обеспечить, чтобы оно работало.

Например

Если мы делаем интернет-магазин для продажи телевизоров, задача QA в первую очередь - убедиться, что пользователь может найти телевизор, нажать “Купить” и заплатить деньги. Это - в первую очередь.

То, что при этом баннер съехал, кнопка “Распечатать PDF” открывается в новом окне, кнопка “login” пропадает через раз - это, конечно, ошибки, но они уже второстепенные. Если они есть, будет хреново, конечно, но бизнес будет продолжать работать. А вот если кнопка “Купить” не кликается - пиши пропало, бизнес встал. Это большая разница!

Ну и совсем уж третьесортные “ошибки” - это когда пользователь вбивает в поле “логин” тысячу символов и получает бяку. Да ни один нормальный пользователь никогда так не сделает! А если кто-то и сделает, то пусть и получает свою бяку. Ибо нефиг!

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

Отсюда главный вывод:

Ваш первый тест - “зелёный путь”. То есть типичный случай, который приносит прибыль:
Найти телек - “Купить” - заплатить. Неважно, пишите ли вы автоматические тесты или тестируете вручную. Первый тест - зелёный путь.

С ним есть одна маленькая проблемка. Это самый скучный тест. Это гарантированный способ находить меньше всех багов в отделе. Это гарантированный способ создать у начальства впечатление, что вы нифига полезного не делаете. Но именно это - первоочерёдная задача QA.
Все эти дебильные тесты про “1000 символов в поле логин” - делать надо, только если всё остальное хорошо. И реально больше некуда девать свободное время. То есть практически никогда. Но именно их тестировщики фигачат в каждом релизе в диких количествах, генерируя тонны никому-не-нужных, не приносящих пользы баг-репортов. Эти баг-репорты сжирают ваши ресурсы и отвлекают внимание от по-настоящему серьёзных проблем, которые проскальзывают незамеченными.

Зато это отличный способ находить по 50 багов в релиз и стать лучшим работником месяца. Это называется “локальная оптимизация”, и это лучшее изобретение дьявола.

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

Поэтому я говорю:

Мы не ищем баги

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

In testo veritas!

Изменения в Selenide 2.15

2014-11-03T00:00:00+00:00

Здрасьте!

Хорошие новости: вышла новая версия Selenide 2.15. На сей раз нас ждёт много нового. Садитесь поудобнее, начинаем обзор новинок!

Sizzle селекторы (CSS3)

Теперь в Selenide можно использовать CSS3 селекторы для поиска элементов!

Например:

$(":contains('Tere Martin!')").shouldBe(visible);
$(":not(a#id)");
$$(":not(div,p)").shouldHave(size(3));
$("[value!='johnny']");
$("div:has(span)");
$(":input");
$(":text");
$(":checkbox");
$(":file");
$(":password");
$(":image");
$(":header");
$(":first");
$(":last");
$(":even");

Возможность пока новая и мало исследованная, поэтому по умолчанию она выключена. Включить её можно такой командой:

Configuration.selectorMode = Sizzle;

Попробуете - расскажите, как получилось.

Загрузка многих файлов (multifile upload)

Теперь функции $.uploadFile() и $.uploadFileFromClasspath() могут принимать несколько аргументов. То есть с помощью Selenide можно загружать несколько файлов! В стандартном Selenium webdriver этой функции нет и в ближайшее время не предвидится, поэтому нам пришлось реализовать эту возможность с помощью чёрной магии и напильника. Попробуйте!

Поддержка BrowserMob proxy

Мы добавили в Selenide удобную возможность добавлять в вебдрайвер Proxy сервер. В первую очередь это было сделано, конечно, ради BrowserMob proxy - популярного среди тестировщиков инструмента. Он позволяет перехватывать http-запросы между веб-приложением и браузером, что даёт массу дополнительных возможностей, недоступных в чистом Selenium webdriver:

загрузка файлов с сервера,
работа с сайтами, требующими авторизации,
проверка кодов ответа на HTTP-запросы,
и т.д.

Подробнее о BrowserMob Proxy можно узнать в замечательном докладе Алексея Баранцева.

Спасибо Владимиру Денисову за этот pull request!

Пример использования BrowserMob Proxy в связке с Selenide можно найти в тесте ProxyServerUsageTest.java:

ProxyServer proxyServer = new ProxyServer(findFreePort());
proxyServer.start();
proxyServer.newHar("google-test");
WebDriverRunner.setProxy(proxyServer.seleniumProxy());

open("http://google.com");

List<HarEntry> harEntries = proxyServer.getHar().getLog().getEntries();
assertTrue(harEntries.get(0).getRequest().getUrl().equals("http://google.com"));

Теперь можно зумить страницу!

Примеры использования, опять же, смотрим в тестах:

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

zoom(2.0); // Увеличить зум вдвое
zoom(0.5); // Уменьшить зум вдвое

Иногда полезно для тестирования responsive design.

Поддержка JSON и iCal

Теперь можно открывать не-html страницы.

Раньше Selenide грохался при попытке открыть не-HTML страницу. Теперь работает.

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

assertThat(source(), containsString("DTSTART:20140409T090000"));

Поддержка табов и фреймов

Теперь Selenide позволяет легко переключаться между вкладками и фреймами не только по заголовку (title), но и по индексу (0, 1, 2, …).

Примеры работы с фреймами:

switchTo().frame(0);
assertTrue(source().contains("Hello, WinRar!"));

switchTo().defaultContent();
switchTo().frame(1);
$("h1").shouldHave(text("Page with dynamic select"));

Примеры работы со вкладками:

switchToWindow(1); 
$("h1").shouldHave(text("Page with JQuery"));

switchToWindow(2); 
$("h1").shouldHave(text("File uploads"));

switchToWindow(3); 
$("h1").shouldHave(text("Page with alerts"));

switchToWindow(0); 
$("h1").shouldHave(text("Tabs"));

Поддержка Allure Framework

Добавилась функция для получения скриншота в виде файла:

import static com.codeborne.selenide.Screenshots.getScreenShotAsFile;

File screenshot = getScreenShotAsFile();

Эта функция понадобится для интеграции с Allure Framework.

Спасибо Владимиру Денисову за этот pull request!

Обновились до Selenium 2.44.0.

Внимание, вместе с этим обновилась и версия библиотеки Google Guava до 18.0.
С этой версией перестал работать PhantomJS :( Я уже сделал Pull Request в ghostdriver, теперь ждём, когда его зарелизят.

А что у вас новенького?

Доклад про Selenide на конференции ConfeT&QA

2014-10-12T00:00:00+00:00

Всем привет!

В ноябре 2013 прошла онлайн-конференция по тестированию ConfeT&QA.

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

Selenide: лаконичные и стабильные UI тесты на Java

Конечно, стоит упомянуть, что на ConfeT&QA 2013 было и много других очень полезных докладов. Спасибо организаторам за организацию и участникам за участие! Надеюсь, не в последний раз.

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

Надеюсь, не в последний раз.

Андрей Солнцев
ru.selenide.org

Изменения в Selenide 2.13 и 2.14

2014-09-28T00:00:00+00:00

Всем привет!

В сентябре мы успели зарелизить сразу две версии: Selenide 2.13 и 2.14. Функций там немного, но есть одна принципиально важная, с неё и начнём.

Быстрый метод $.setValue

Мы в Codeborne анализировали производительность тестов на реальных проектах и заметили, что самая медленная операция - это не поиск по XPath, как многие думают, а заполнение текстовых полей. То есть функция $.setValue (она же WebElement.sendKeys). Дело в том, что по умолчанию Selenium при заполнении поля эмулирует нажатия каждой отдельной клавиши со всеми сопутствующими событиями: keyDown, keyUp и пр. - что делает метод sendKeys относительно медленным.

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

Мы придумали следующее решение проблемы. Пусть в Selenide будет два разных метода: $.sendKeys и $.setValue. Первый будет работать как Selenium по умолчанию, то есть медленно и с генерацией событий. Второй будет работать быстро, устанавливая значение поля через JavaScript. Тогда автор теста сам сможет решить, какой из методов нужен в каждом отдельном случае. В большинстве случаев можно использовать метод $.setValue, ибо автопоисков не так-то много в сравнении с массой “обычных” полей.

На наших проектах использование быстрого метода $.setValue дало заметную экономию примерно в 10%.

NB! Эта фича пока экспериментальная и включается флагом -Dselenide.fastSetValue=true. По умолчанию она выключена, и $.setValue работает так же, как и $.sendKeys.

Добавлен метод для проверки картинок `$("img").isImage()`

Метод $("img").isImage() возвращает true, если картинка корректно загрузилась. Вызывать метод можно только для элементов <img>.

Пример использования можно подсмотреть в тесте ImageTest.

NB! Функция почему-то не работает в HtmlUnit.

Добавилась возможность писать поясняющее сообщение к проверкам (как в ассертах JUnit и TestNG)

Теперь ко всем should-методам можно приписать сообщение:

$("#kpp").shouldBe("У частных лиц КПП всегда пустой", empty);

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

Element should be empty {By.id: kpp} because У частных лиц КПП всегда пустой
Element: '<input id="kpp">012973891263</input>'
Screenshot: file:/Users/andrei/projects/selenide/build/reports/tests/integration/SelenideMethodsTest/waitUntilMethodMayContainOptionalMessageThatIsPartOfErrorMessage/1411898416054.0.png
Timeout: 4 s.

Я не уверен, что эта фича сделана самым удобным образом. Поэтому жду ваших идей. Как, по-вашему, это можно было бы сделать лучше?

Может быть, например, такой вариант был бы удобнее?

$("#kpp").shouldBe(empty.because("У частных лиц КПП всегда пустой"));

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

Есть ещё такой вариант:

$("#kpp").because("У частных лиц КПП всегда пустой").shouldBe(empty);

Ну, и меня смущает ещё слово “because” - ведь в разных ситуациях было бы удобнее вместо “because” использовать другие слова.

А что вы думаете?

Добавились врапперы `be` и `have`.

Теперь проверки можно писать ещё и так:

$("#username").should(have(text("Ivan")));
$("br").should(be(empty));

Это может быть полезно при использовании Selenide с фреймворками типа EasyB, которые тоже используют слова shouldBe или shouldHave для своих целей.

Обновились до Selenium 2.43.1.

Этого релиза Selenium WebDriver все очень ждали. Во-первых, из-за поддержки FireFox 32, а во-вторых, из-за нового драйвера для InternetExplorer.

Проблем с новым Selenium 2.43.1 замечено не было.

А что у вас новенького?

Как начать писать UI тесты за 10 минут

2014-09-25T00:00:00+00:00

Привет!

Очень часто я слышу этот вопрос: как научиться писать тесты? С чего начать? Как написать первый тест на Selenium?

И вот наконец у нас есть ответ!

В этом видео-уроке показано, как создать проект на Maven и написать тест, который открывает Google в браузере, вбивает слово для поиска и проверяет результаты.

Как написать UI тест за 10 минут from Selenide on Vimeo.

Туториал по Selenide

Конструктивная критика приветствуется.

Заметки об использовании Selenide: IE, TestNG, Bootstrap dropdown

2014-08-25T00:00:00+00:00

Привет!

Меня зовут Сергей Шимкив, и я хочу поделиться с вами своими заметками об использовании Selenide/Selenium.

Заметки об IE

IE 11 x32/x64. В некоторых случаях после действий с HTML элементами (например, click()) вы можете получить ошибку.
Проблема в использовании синтетических событиях. Решение - использовать нативные события для IE:

   capabilities.setCapability("nativeEvents", "true");

См. https://code.google.com/p/selenium/wiki/InternetExplorerDriver

Один способ добавить скриншоты Selenide в TestNG HTML репорт

Иногда было бы неплохо добавить скриншоты Selenide от упавших тестов в ваш TestNG HTML отчёт.

К примеру: Вы написали два теста (Test1 и Test2), которые должны быть связаны (Test2 зависит от результатов Test1). Но вы знаете, что Test1 точно упадёт из-за ошибки приложения.

Поэтому вы пишете нечто подобное:

   @Test(...)
   public void Test1() {
    ...
    try {
      // Кусок теста с известным багом
    } catch(...) {
      // Некоторые действия
    } finally {
      // Действия, чтобы обеспечить корректные условия для запуска Test2
    }
   }

Допустим, вы используете свой тест листенер, который наследует TestListenerAdapter. И вы переопределили метод onTestFailure(ITestResult result), чтобы собирать дополнительную информацию в HTML отчёт - например, ваши собственные скриншоты. В этом случае может статься, что ваш код будет собирать неправильную информацию о скриншотах, т.к. блок finally может быть выполнен ДО того, как Selenide сделает скриншот.

Какой же выход?

Просто помните, что имя файла скриншота, который делает Selenide (после любой ошибки), доступно из result.getThrowable().getMessage();

Один способ работать с кастомизированными Bootstrap HTML элементами

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

К примеру, бутстраповский выпадающий список (dropdown) реализован как набор HTML элементов. Обычно это выглядит как-то так:

  <div class="dropdown">
    <button class="btn btn-default dropdown-toggle" type="button" id="dropdownMenu1" data-toggle="dropdown">
      Dropdown
      <span class="caret"></span>
    </button>
    <ul class="dropdown-menu" role="menu" aria-labelledby="dropdownMenu1">
      <li role="presentation"><a role="menuitem" tabindex="-1" href="#">Действие</a></li>
      <li role="presentation"><a role="menuitem" tabindex="-1" href="#">Другое действие</a></li>
      <li role="presentation"><a role="menuitem" tabindex="-1" href="#">Что-то ещё</a></li>
      <li role="presentation" class="divider"></li>
      <li role="presentation"><a role="menuitem" tabindex="-1" href="#">Отдельная ссылка</a></li>
    </ul>
  </div>

Проблема в том, что элемент <ul> изначально невидимый. Selenium (а значит, и Selenide) его не видит и поэтому не может кликнуть. Чтобы выбрать элемент выпадающего списка, вам нужно:

   SelenideElement parentDiv = $(".dropdown");
   
   // Найти элемент `<button>` и `click()` его
   parentDiv.find("button").scrollTo().click();
   
   // Теперь можете найти нужный элемент выпадающего списка по тексту
   parentDiv.find(".dropdown-menu").find(withText("Действие")).parent().click();

В следующем посте я поделюсь опытом автоматической инсталляции а тестовую среду (основанной на Grid2).

Спасибо авторам Selenide за отличный тул ;)

Сергей Шимкив

Укороти свой код!

2014-08-08T00:00:00+00:00

Всем привет!

Вашему вниманию представляется Prezi презентация про Selenide от Ashwin Dalvi.

Плюсы, Минусы и Мифы:

Selenide: Укороти свой код!

Изменения в Selenide 2.12

2014-07-05T00:00:00+00:00

Всем привет!

Хорошие новости: мы зарелизили Selenide 2.12. Давайте посмотрим, что там новенького.

Добавилась функция $.uploadFile(File)

Новая функция позволяет загрузить файл.

   File cv = new File("src/test/resources/cv.pdf");
   $("#cvFileUpload").uploadFile(cv);

Раньше в Selenide уже была похожая функция $.uploadFromClasspath(String fileName). Она искала файл для загрузки в classpath. Нам всегда казалось, что держать тестовые файлы вместе с кодом самих тестов - это правильно (а значит, при сборке проектов эти файлы будут попадать в classpath). Но оказалось, что иногда удобно и загрузить какой-то файл из другого места.

Исправили функцию $.uploadFromClasspath

Выяснилось, что вебдрайвер ругается, если попытаться загрузить файл вида c:/src/test/java/../resources/cv.pdf. Мы дополнили функцию $.uploadFromClasspath, так что она теперь выкидывает лишние части, т.е. нормализует имя файла.

   $("#cvFileUpload").uploadFromClasspath("cv.pdf");

Функция $.val(“джонни”) работает и для селектов

Функция $.val стала немножко умнее. Если её вызвать для поля SELECT, то теперь она выбирает нужный OPTION с соответствующим value. Это ещё один шаг в том направлении, чтобы программист не должен был думать о реализации веб-элемента и мог сконцентрироваться на бизнес-логике. Программист просто пишет $("#sex").val("female") и не думает, что это: INPUT или SELECT - Selenide сама поймёт и сделает нужное действие.

Технически, $("select").val("yes") - это синоним для $("select").selectOptionByValue("yes").

Добавилась функция `getWebDriverLogs()`.

Функция позволяет прочитать логи браузера. Технически - webdriver.manager().logs(). По идее, эти логи могут содержать очень полезную информацию об ошибках браузера или javascript, проблемах производительности и пр. Но фактически функция поддерживается не всеми вебдрайверами и работает непонятно. Если вы знаете об этом больше - поделитесь с нами!

Обновились до Selenium 2.42.2 и HtmlUnit 2.15

Проблем с новым селениумом замечено не было. Работает как часы.

Спасибо авторам Selenium за чудесный продукт!

А что у вас новенького?

Изменения в Selenide 2.11

2014-05-23T00:00:00+00:00

Всем привет!

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

Пожалуйста, попробуйте запустить свои тесты с Selenide 2.11 и дайте знать, если что-то сломалось.

Что мы подчистили

Убрали зависимость от jQuery

Раньше методы $.selectOption() и $.selectOptionByValue() пытались с помощью jQuery сгенерировать событие “change”. Это было сделано когда-то давно для борьбы с тестами, падающими под Windows в IE. Теперь это уже неактуально - во всяком случае, все тесты в наших проектах проходят и так.

И вообще, весь класс com.codeborne.selenide.JQuery теперь помечен как deprecated. Проверьте, что вы не используете его в своих тестах.

Подчистили надоедливые логи

Раньше при попытке закрыть Firefox в лог писалось такое бесполезное раздражающее сообщение:

“UnreachableBrowserException: Error communicating with the remote browser. It may have died.”

Мы присмотрелись и поняли, что это бага (или особенность) в Selenium Firefox webdriver. При вызове метода webdriver.close() он выкидывает ошибку UnreachableBrowserException, но при этом браузер всё-таки закрывает (во всяком случае, в Linux и Mac OS).

В общем, мы убрали этот лог.

И что обновили

Обновились до PhantomJS 1.2.0

Как и раньше, все тесты самого Selenide пробегают на PhantomJS, но некоторые тесты на реальных проектах валятся. Так что использовать его полноценно в работе пока не можем. Будем следить за обновлениями фантома.

А что у вас новенького?

Изменения в Selenide 2.10

2014-04-27T00:00:00+00:00

Всем привет!

Недавно вышла версия Selenide 2.10. Что новенького нас ждёт?

Новые функции

Работа с вкладками и окнами

В Selenium WebDriver неудобно работать с окнами. Selenium предлагает только метод getWindowHandles(), который возвращает множество (Set) строк - идентификаторов открытых окон. Найти среди них нужное - нетривиальная задача.

Поскольку задача Selenide - освободить голову программиста от технических вопросов, мы хотим сделать работу с окнами/вкладками максимально простой и интуитивной. Начали мы с простого: добавили метод

Selenide.switchToWindow(String title)

Пример использования можно подсмотреть здесь:

@Test
  public void canSwitchToWindowByTitle() {
    $(byText("Page2: alerts")).click();
    $(byText("Page1: uploads")).click();

    switchToWindow("Test::alerts");
    $("h1").shouldHave(text("Page with alerts"));

    switchToWindow("Test::uploads");
    $("h1").shouldHave(text("File uploads"));
  }

У нас в планах продолжать работу в этом направлении. Возможно, с использованием новых фич из Java 8.

А как вам было бы удобнее с окнами и фреймами? Делитесь своими идеями!

Новые методы для динамики `$.hover()` и `$.dragAndDropTo(target)`

Метод $.hover() эмулирует наведение мышкой на элемент (без клика). Примеры здесь.

А метод $.dragAndDropTo(target) позволяет перетащить элемент в другое место. Пример:

  $("#from").dragAndDropTo("#to")

Новые методы для поиска родительских элементов $.parent() и $.closest()

Часто в тестах бывает удобно найти родительский элемент. Или даже не просто родительский, а ближайший потомок, соответствующий какому-то критерию. Например, я часто ищу по тексту DIV, находящийся внутри таблицы, и затем хочу получить ряд таблицы, в котором этот DIV находится. Раньше это иначе как через XPath сделать было невозможно.

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

  $(byText("Row 1")).parent();
  $(byText("Row 2")).closest("tr");
  $(By.name("firstName")).closest(".form");

Пример здесь

Ловля JavaScript ошибок

Теперь Selenide пытается автоматически отлавливать JavaScript ошибки, случающиеся на странице.

Что мы с ними делаем?

Прежде всего, когда ваш тест падает, Selenide автоматически добавляет в сообщение об ошибке список JS ошибок (если они были). В принципе этого уже достаточно. Но если вы хотите большего контроля, есть два специальных метода:

Selenide.getJavascriptErrors() - возвращает список всех ошибок на текущей странице.
Selenide.assertNoJavascriptErrors() - валит тест, если были какие-то ошибки.

P.S. Пока что это делается довольно просто (через функцию window.onerror). Она вроде как не во всех браузерах работает, и не все ошибки отлавливает, так что если у вас есть соображения, как это можно делать лучше - смело делитесь.

Багфиксы и улучшения

Закрытие вебдрайверов

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

Selenide больше не ждёт появления <body>

Метод open(url) больше не ждёт, пока в теле страницы появится тэг <body>. Этот атавизм остался с тех давних пор, когда Selenide ещё умел ожидать наступления событий.

Метод savePageSourceToFile пытается закрыть все `alert`.

Когда в ходе выполнения теста на странице выскакивает неожиданный alert, грохается не только сам тест, но и попытка сделать скриншот, и даже попытка сохранить исходный код страницы.

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

Обновились до Selenium 2.41.0

Как обычно, мы обновились до последней версии Selenium.

Каких-то проблем с новым селениумом пока не замечено. Всё работает как часы.

Другие новости

Мартовская статистика скачиваний Selenide из центрального репозитория несказанно нас порадовала.

Нас резко стало почти вдвое больше!

А что у вас новенького?

Изменения в Selenide 2.9

2014-03-15T00:00:00+00:00

Всем привет!

Сегодня вышла версия Selenide 2.9. Давайте посмотрим, что хорошего несёт с собой новая версия.

Что новенького нас ждёт

Добавлена поддержка браузера Safari

Но сам Safari всё ещё кажется нестабильным. Во всяком случае, не все тесты самого Selenide проходят на Safari.

И ещё он не поддерживает alert‘ы и не умеет открывать локальные файла типа file://c:/tmp.txt. А какой у вас опыт работы с вебдрайвером Safari?

Добавлен condition `or`

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

    Condition completed = or("completed", started, inProgress, loading);

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

    $("div#page").shouldBe(completed);

Я совсем не уверен, что это хороша идея. На мой взгляд, тест всегда точно должен знать, в каком состоянии объект. Но просьбам трудящихся сделал.

Добавлен метод `ScreenShooter.to(folder)`

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

public class MyTest {
  @Rule
  public ScreenShooter photographer = failedTests().to("test-results/reports");
}

Опять же, не уверен, что это нужно, ведь путь к скриншотам можно задать глобально через системное свойство: -Dselenide.reports=test-results/reports или программно: Configuration.reportsFolder=test-results/reports. Так что польза от нового метода будет только в том случае, если вам нужно складывать скриншоты от разных тестов в разные места.

Багфиксы и улучшения

Метод `$.download()` кидает `FileNotFoundException` (если сервер вернул статус 40x) или `RuntimeException` (для статуса 50x)

До этого метод $.download() возвращал пустой файл в случае серверной ошибки. Конечно, тестировать это было неудобно.

Окно хрома тоже максимизируется

Из-за баги в ChromeDriver окно браузера Chrome не открывалось на весь экран. Теперь открывается. Правда, для этого пришлось применить чёрную магию из java.awt.

Метод `$.shouldHave(text())` игнорирует также и символ \u00a0 (т.н. “non-breaking space”)

До этого проверка $(".error").shouldHave(text("Hello, Johny!")) игнорировала все пробелы. Но вот про символ \u00a0 мы забыли. А он часто используется в вебе, например, при форматировании сумм или дат. Например, такая проверка могла упасть:

  $(".amount").shouldHave(text("123.45 EUR"));

А теперь работает.

Улучшение закрытие браузеров при многопоточном запуске тестов в TestNG

До сих пор Selenide открывал и закрывал браузер в одном и том же потоке. Обычно этого хватает.

Но выяснилось, что TestNG при многопоточном запуске тестов запускает сами тесты и метод @AfterSuite в разных потоках. Пришлось этот код переписать. Теперь Selenide сам автоматически закрывает все неиспользуемые браузеры сразу, как только соответствующий поток завершает свою работу.

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

Включение ошибки вебдрайвера

Когда проверка типа $.shouldBe(visible) падает из-за ошибки вебдрайвера, эта ошибка больше не игнорируется, а добавляется к стандартной селенидовской ошибке Element should be visible. Теоретически это может быть полезно, если браузер повёл себя неадекватно. Например, у людей были случаи, когда IE время от времени ругался на валидный xpath.

Если не получается сделать скриншот, Selenide пишет ошибку со стектрейсом.

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

Selenide сохраняет исходный код страницы в правильной кодировке (UTF-8)

До этого Selenide могла сохранять HTML в неправильной кодировке, в зависимости от настроек оп. системы.

Убраны INFO-сообщения насчёт “reportsUrl” и “BUILD_URL”

Как оказалось, они многих сбивали с толку.

Но вообще-то автоматические скриншоты в Jenkins - это очень крутая фича, которая до сих пор остаётся неанонсированной. Об этом скоро будет отдельный большой пост с картинками.

Использование слова “`jQuery`” вместо “`$`”

Кое-где Selenide использовал символ “$”, чтобы поддерживать события javascript. Это могло вызывать проблемы в случае приложений, использующих и jQuery, и Prototype или какой-нибудь другой JS фреймворк.

Обновились до Selenium 2.40.0, HtmlUnit 2.14 и TestNG 6.8.8

Как обычно, мы обновились до последних версий Selenium и TestNG.

Внимание, в версии 6.8.8 из TestNG выпилили поддержку junit. Так что если у вас почему-то в проекте используется и TestNG, и JUnit, и последний подтягивается транзитивно, то он больше не подтянется.

Так что жизнь бьёт ключом!

А что у вас новенького?

Selenide downloads: 200 уникальных IP

2014-03-12T00:00:00+00:00

Не все знают, но Central Maven Repo раз в месяц публикует статистику скачиваний разных артефактов.

Сегодня опубликована статистика скачиваний Selenide за февраль. На картинке - количество уникальных IP-адресов, с которых скачивался selenide.jar из центрального репозитория.

Похоже, мы сделали большой скачок! Ура!

Selenide за пять минут от Glen Smith

2014-03-11T00:00:00+00:00

Ух ты!

Glen Smith презентовал библиотеку Selenide на JUG в Канберре.

Это классная 5-минутная живая демонстрация Selenide. За пять минут Глен успел и рассказать, и написать, и запустить полноценный рабочий тест, причём не для чего-нибудь, а для гуглового сервиса поиска картинок. А это, знаете, не так просто: там ведь аякс и всё такое.

Наслаждайтесь!

Оригинальный пост: [Selenide in Five Minutes: A lightning talk](http://blogs.bytecode.com.au/glen/2014/02/13/selenide-in-five-minutes-a-lightning-talk.html)

Глен Смит - инженер из Австралии, соавтор книги “Grails in Action”.

Больше информации о нём можно найти в его блоге blog.

Отличная работа, @glen_a_smith!

Футболка Selenide

2013-10-04T00:00:00+00:00

Привет!

Как вы уже успели заметить, у Selenide появилось новое лого и новый дизайн.

И даже свои футболки. Всё по-взрослому!

Три такие замечательные футболки мы разыграем уже на следующей неделе на конференции XP Days в Киеве.

Selenide Harlem Shake

2013-08-29T00:00:00+00:00

Привет!

Это видео, демонстрирующее, насколько легко начать писать автоматические тесты с Selenide.

Мы хотели создать скринкаст, который был бы коротким, весёлым и в то же время информативным. И кстати, это реальный проект, а не какой-нибудь там Hello Word.

Смотреть со звуком!

Selenide Harlem Shake from Selenide on Vimeo.

Может ли PhantomJS делать скриншоты?

2013-07-15T00:00:00+00:00

Многие думают, что PhantomJS как headless-браузер не умеет делать снимки экрана.

А вот и неправда!

Согласно документации PhantomJS, он умеет делать скриншоты.

Давайте-ка попробуем.

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

public class TestPhantomScreenshot {
  public static void main(String[] args) {
    System.setProperty("browser", "phantomjs");
    open("http://google.com");
    screenshot("google-com-screenshot");
    close();
  }
}

Это работает!

Впрочем, работает неидеально. Скриншоты google.com, habrahabr.ru и skype.com выглядят неплохо, но вот скриншот selenide.org смотрится весьма странно.

Значит ли это, что PhantomJS ещё недостаточно зрелый продукт? Не знаю. Но всяком случае теперь мы знаем точно, что PhantomJS умеет делать скриншоты.

Видео: Selenide на SeleniumCamp 2013

2013-05-09T00:00:00+00:00

Наш доклад про Selenide на конференции SeleniumCamp 2013 в Киеве

Часть первая, введение в Selenide:

Часть вторая, живая демонстрация Selenide:

парное программирование
ping-pong programming
программируем настоящий интернет-банк

Что такое Selenide

2013-04-23T00:00:00+00:00

Многие слышали про Selenium WebDriver - один из самых популярных инструментов для написания приёмочных/интеграционных тестов.

Написание UI тестов - непростая задача. Есть ряд проблем, с которыми сталкиваются все без исключения - это Ajax-запросы, динамические страницы и, чёрт их подери, таймауты. Главная цель Selenide - решить эти проблемы.

Что такое Selenide

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

Вот пример теста. Как видите, код минимален. Вызвал метод open - и браузер открылся.

@Test
public void testLogin() {
  open("/login");
  $(By.name("user.name")).sendKeys("johny");
  $("#submitButton").click();
  $("#username").shouldHave(text("Hello, Johny!"));
  $(".error").shouldNotBe(visible);
}

При вызове метода open Selenide сам запускает браузер и открывает страницу http://localhost:8080/login (порт и хост конфигурируется, естественно). А также заботится о том, чтобы в конце браузер закрылся.

Ключевые особенности Selenide

Если вкратце, вот главные особенности Selenide

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

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

Дополнительные вкусности Selenide

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

@Test
public void canFillComplexForm() {
  open("/client/registration");
  $(By.name("user.name")).setValue("johny");
  selectRadio("user.gender", "male");
  $(By.name("user.securityQuestion")).selectOption("What is my first car?");
  $(By.name("user.preferredLayout")).selectOptionByValue("plain");
  $("#submit").followLink();
  takeScreenShot("complex-form.png");
}

@Before
public void clearCache() {
  clearBrowserCache();
}

Как побороть Ajax?

Ajax - это засада для UI тестировщиков. При тестировании приложений, использующих Ajax, приходится изобретать код, который чего-то ждёт (когда кнопка станет зелёной). Selenide решает эту проблему как никто другой. В то время как Selenium предлагает богатый API для ожидания разного рода событий Например, Selenide просто предлагает вам не заморачиваться. Если вы хотите поверить, что кнопка зелёная, а она пока что не зелёная, Selenide просто подождёт, пока она станет зелёной. Конечно, таймаут конфигурируется (по умолчанию 4 секунды). Это уникальное решение - простое и надёжное.

@Test
public void pageUsingAjax() {
  $("#username").shouldBe(visible);   // ждёт, пока элемент появится
  $("#username").shouldHave(text("Hello, Johny!")); // ждёт, пока текст элемента изменится на "Hello, Johny!"
  $("#login-button").shouldHave(cssClass("green-button")); // ждёт, пока кнопка станет зелёной
  $("#login-button").shouldBe(disabled); // ждёт, пока кнопка станет неактивной
  $(".error").shouldNotBe(visible);  // ждёт, пока элемент исчезнет
  $(".error").should(disappear);     // попробуйте-ка сделать это с Selenium в одну строчку!
}

Как автоматически делать скриншоты?

Легко! Если вы используете JUnit, просто добавьте эту строчку в свой тестовый класс:

   @Rule
   public ScreenShooter makeScreenshotOnFailure = ScreenShooter.failedTests();

Тогда после каждого упавшего теста будет автоматически создаваться скриншот (на самом деле два файла, .PNG и .HTML).

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

   @Rule
   public ScreenShooter makeScreenshotOnEveryTest =
              ScreenShooter.failedTests().succeededTests();

Если вы используете TestNG, просто добавьте следующую аннотацию к своему тестовому классу:

@Listeners({ ScreenShooter.class})

Я хочу попробовать, с чего начать?

Добавь в свой проект зависимость Selenide:

<dependency>
    <groupId>com.codeborne</groupId>
    <artifactId>selenide</artifactId>
    <version>7.2.3</version>
</dependency>

Импортируй нужный класс:

import static com.codeborne.selenide.Selenide.*

И готово! Пиши тесты, едрён-батон!

Зачем ещё один велосипед?

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

И мы подумали: почему создание UI-тестов должно быть таким сложным? Поэтому мы решили выделить этот повторяющийся код в отдельную библиотеку. Так на свет появился Selenide.

Кто-нибудь это реально использует?

Да, мы в фирме Codeborne используем Selenide в нескольких реальных проектах:

Интернет-банки
Порталы самообслуживания
и т.д.

с разными языками и тестовыми фреймворками:

Java + ANT + JUnit
Java + Gradle + JUnit
Scala + ANT + ScalaTest
Groovy + ANT
и т.д.

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

Покажите мне работающий пример!

Есть небольшой эталонный open-source проект, в котором используется Selenide: игра Виселица.

А также мы создали проект Selenide examples, где мы храним примеры использования Selenide для тестирования Gmail, Google и других классических примеров.

Откуда такое название - Selenide?

Библиотека Selenide взяла своё название от химического элемента (Селен). А селениды - это соединения селена с другими элементами.

Вот и у нас:

Selenide = Selenium + JUnit
Selenide = Selenium + TestNG
Selenide = Selenium + ScalaTest
Selenide = Selenium + что угодно

Химичьте на здоровье!

Поделитесь с нами опытом!

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

Selenide

Вышла 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() для подсветки элемента

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

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

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

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

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

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

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

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

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

Новости

Вышла Selenide 6.18.0

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

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

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

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

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

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

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

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

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

Статистика

Вышла Selenide 6.17.2

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

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

Вышла Selenide 6.17.1

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

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

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

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

Вышла Selenide 6.17.0

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

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

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

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

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

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

Статистика

Сообщение об ошибке, если нет `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)`

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

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

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

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

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

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

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

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

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

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

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

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