Selenide

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

Selenide

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

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

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

Статистика

Вышла Selenide 6.16.1

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

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

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

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

Вышла Selenide 6.16.0

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

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

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

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

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

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

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

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

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

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

Новости

Вышла Selenide 6.15.0

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

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

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

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

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

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

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

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

Переколбас CollectionCondition

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

Новости

Вышла Selenide 6.14.0

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

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

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

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

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

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

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

Новости

Статистика

Вышла Selenide 6.13.0

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

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

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

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

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

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

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

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

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

Новости

Вышла Selenide 6.13.0

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

Добавили метод `$$.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`

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

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

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

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

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

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

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

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

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

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

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