com.codeborne.selenide.SelenideElement [src]

Класс SelenideElement - обёртка вокруг Selenium WebElement, которая добавляет несколько весьма полезных методов.

Cам объект SelenideElement, который возвращается методом $ - является прокси-элементом. В момент создания с помощью $ реальный элемент на странице не ищется. Зато потом при любой попытке совершить с прокси-элементом какое-то действие или проверку - прокси-элемент получает последнюю актуальную "версию" реального элемента со страницы (типа WebElement) и "проксирует" ей указанное действие или проверку.

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

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

//до открытия браузера и загрузки страницы
class HomePage {
  private SelenideElement menu = $("#menu");

  public void openStream() {
      this.menu.find(byLinkText("Stream")).click();
  }

  public void openProfile() {
      this.menu.find(byLinkText("Profile")).click();
  }
}
HomePage home = new HomePage();
//теперь команда $ уже была вызвана и был создан SelenideElement, а даже браузер еще не октрыт
//...
open("/home"); //открылся браузер и была загружена страница
home.openProfile(); // только теперь была получена актуальная версия элемента-меню со страницы, в ней внутри был найден элемент-ссылка с текстом Stream, и ему была "проксирована" команда click()
//...много чего могло произойти
home.openStream(); //и тепеь перед нахождением элемента-ссылки с текстом Profile для того, что-бы совершить на нем click() - снова была получена актуальная версия элемента-меню на странице
//...

Для SelenideElement определенны методы следующего типа:

• методы поиска внутренних элементов

  • а точнее методы создания прокси-элементов представляющих элементы внутри данного

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

• методы-действия над элементом

• методы получения статусов элементов и значений их атрибутов

• другие

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

Методы поиска внутренних элементов

• find(String cssSelector) | $(String cssSelector)

• find(By) | $(By)

• findAll(String cssSelector) | $$(String cssSelector)

• findAll(By) | $$(By)

Здесь $ и $$ просто лаконичные "алиасы" (синонимы) для соответствующих команд.

Все эти методы возвращают "прокси-элементы", то есть не ищут реальные элементы до тех пор пока не будет вызвано какое то действие над элементом (например .click())

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

$("#header").find("#menu").findAll(".item")

И при этом можно сохранить "цепочку поиска" любой длины в переменную, независимо от того, загружена ли страница на момент инициализации переменной, или даже открыт ли браузер, например:

//до открытия браузера и загрузки страницы
SelenideElement menu = $("#menu");
SelenideElement streamMenu = menu.$(By.linkText("Stream"));
SelenideElement profileMenu = menu.$(By.linkText("Profile"));
//...
open("/main");
profileMenu.click();
//...
streamMenu.click();
//...

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

Методы-проверки - assertions - инициируют для прокси-элемента поиск актуальной версии элемента на странице, совершают проверку по предикату ("условию" - объекту-кондишену класса Condition), и возвращают объекты SelenideElement, позволяя использовать цепочки вызовов.

• should(Condition) | shouldBe(Condition) | shouldHave(Condition)

• shouldNot(Condition) | shouldNotBe(Condition) | shouldNotHave(Condition)

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

$("input").should(exist);  
$("input").shouldBe(visible);
$("input").shouldHave(exactText("Some text"));

Проверки играют роль явных ожиданий (explicit waits) в Selenide. Они ждут до удовлетворения условия (visible, enabled, text("some text")) пока не истечет таймаут (значение Configuration.timeout, которое установлено по умолчанию в 4000 миллисекунд).

Можно использовать проверки явно - с целью ожиданий нужного состояния у элементов перед действием, e.g. $("#submit").shouldBe(enabled).click();

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

• waitUntil(Condition, milliseconds)

• waitWhile(Condition, milliseconds)

Методы-действия над элементом

Действия над элементами

• click()

• doubleClick()

• contextClick()

• hover()

• setValue(String) | val(String)

• pressEnter()

• pressEscape()

• pressTab()

• selectRadio(String value)

• selectOption(String)

• append(String)

• dragAndDropTo(String)

• ...

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

Действия имеют встроенные неявные ожидания (implicit waits) до видимости элемента пока не истечет таймаут (значение Configuration.timeout, которое установлено по умолчанию в 4000 миллисекунд).

Следовательно код $("#submit").shouldBe(visible).click() избыточен и будет достаточно $("#submit").click().

Большинство действий также возвращают обьект SelenideElement, позволяя использовать цепочки вызовов, e.g. $("#edit").setValue("text").pressEnter();.

Методы получения статусов элементов и значений их атрибутов

Инициируют для прокси-элемента поиск актуальной версии элемента на странице и имеют разную логику неявных ожиданий в зависимости от контекста:

• Выполняется ожидание до появления элемента в DOM:

  • getValue() | val()

  • data()

  • attr(String)

  • text() // возвращает "видимый текст на странице"

  • innerText() // возвращает "текст элемента в DOM"

  • getSelectedOption()

  • getSelectedText()

  • getSelectedValue()

• Нет ожидания :

  • isDisplayed() //возвращает false, если элемент либо невидимый, либо его нет в DOM

  • exists() //возвращает true, если элемент есть в DOM, иначе - false

Другие полезные команды

• uploadFromClasspath(String fileName)

• download()

• toWebElement()

• uploadFile(File...)