Selenium WebDriver: поиск элементов на странице

Для поиска элементов в Selenium используются локаторы. Локатор – это строка, уникально идентифицирующая элемент страницы. WebDriver предоставляет несколько способов использования локаторов для поиска элементов:

• By.id – в качестве локатора используется атрибут id элемента страницы;
• By.name – в качестве локатора используется атрибут name элемента страницы;
• By.xpath – используется для поиска элемента по XPath выражению;
• By.tagName – поиск по имени HTML тега;
• By.className – поиск по классу(атрибут class) элемента;
• By.cssSelector – данный тип локаторов основан на описаниях таблиц стилей (CSS);
• By.linkText – поиск ссылки с указанным текстом. Текст ссылки должен быть точным совпадением;
• By.partionalLinkText – поиск ссылки по части с указанным текстом.

В WebDriver реализованы два метода — findElement и findElements. В качестве параметра они принимают объект типа By, который задает критерий поиска.

• java.util.List findElements(By by) — находит все элементы в текущем контексте, идентифицированные классом By. На время его выполнения влияет implicit wait (неявные ожидания). При выполнении неявного ожидания, метод вернет список сразу же, как только будет найден хоть один элемент, или вернет пустой список, если время ожидания истекло.
• WebElement findElement(By by) — находит первый, удовлетворяющий условиям поиска, элемент на странице. На время выполнения этого метода также влияют неявные ожидания. Если элемент не найден сразу, то метод будет вызываться повторно пока не истечет время ожидания. Если же ничего найти не удалось, будет выдано исключение NoSuchElementException. Поэтому не используйте findElement для проверки отсутствия элементов, вместо этого можно использовать метод findElements и проверку на нулевое количество полученных элементов.

Примеры использования:

<div id="first">
    <a class="red_link">
         <div class="label">Первая ссылка</div>
    </a>
    <a>Вторая ссылка</a>
</div>

WebElement element = driver.findElement(By.id("first"));

driver.findElement(By.tagName("a"));

driver.findElement(By.cssSelector("#first"));

driver.findElement(By.linkText("Вторая ссылка"));

Обратите внимание, что для первой ссылки использовать такой локатор нельзя. Метод findElement(By.linkText("Первая ссылка")) не найдет ни одного элемента. Потому, что искомый текст должен содержаться непосредственно в теге <a>. Первую ссылку можно получить используя, например, className или xpath:

driver.findElement(By.className("red_link"));

driver.findElement(By.xpath(".//*[text()='Первая ссылка']/.."));

Поисковые запросы можно выстраивать в цепочку:

<div id="first">
    <a>Первая ссылка</a>
</div>
<div id="second">
    <a>Вторая ссылка</a>
</div>

driver.findElement(By.id("second")).findElement(By.tagName("a"));

В тоже время найти такой элемент можно с помощью, например, XPath запроса. Что лучше использовать для такого поиска — сложный XPath/CSS запрос или цепочку простых запросов — решать только вам.
Сложный запрос получается более коротким и емким, и его можно предварительно отладить с помощью дополнительных инструментальных средств. Цепочки получаются достаточно длинными (чем сложнее запрос, тем длиннее будет цепочка) и их нельзя отладить перед использованием. Но есть и свои плюсы — если во время выполнения поиска не найден какой-либо элемент, цепочка более точно сообщит о том, что именно не нашлось.