Selenium 简明教程

Selenium WebDriver - Finders

Selenium Webdriver 可用于找到具有相同匹配定位符值的元素。在网页上，如果多个元素具有相同定位符值，则只会获取到第一个匹配元素（从页面的右上角开始）的引用。

findElement Method

findElement() 方法会返回在 DOM 中具有相同定位符值的第一个元素。如果有多个元素具有相同定位符值，则可以使用 id 定位符识别单个元素，因为它始终会在网页上唯一标识一个元素。

Identify Element using the Nested findElement

让我们考虑一个 * HTML* 代码片段的示例，如下图中突出显示的那样，其中元素具有与 li 相同的标记名称。让我们识别具有子元素链接（标记名为“a”）的第一个 li 元素（具有标记名为 ul 的父元素），即 Text Box -

为了捕获该元素，我们首先唯一地识别了搜索元素的祖先元素（而不是不需要元素的祖先）元素，然后对该对象应用 findElement() 方法。

我们可以借助 findElements() 方法获取具有相同定位符值的所有匹配元素。这会返回一个匹配元素列表。如果没有匹配元素，我们将会得到一个大小为 0 的列表。

嵌套命令的语法 -

WebDriver driver = new ChromeDriver();

// identify all elements under tagname ul
WebElement elements = driver.findElement(By.id("navMenus"));

// identify first li element under ul then click
WebElement element = elements.findElement(By.xpath("//li[1]/a"));

Example 1

让我们点击 Text Box 链接，并在网页上获取文本 Text Box 。

代码实现

package org.example;

import org.openqa.selenium.By;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.WebElement;
import org.openqa.selenium.chrome.ChromeDriver;
import java.util.concurrent.TimeUnit;

public class Finders {
   public static void main(String[] args) throws InterruptedException {

      // Initiate the Webdriver
      WebDriver driver = new ChromeDriver();

      // adding implicit wait of 15 secs
      driver.manage().timeouts().implicitlyWait(15, TimeUnit.SECONDS);

      // Opening the webpage
      driver.get("https://www.tutorialspoint.com/selenium/practice/selenium_automation_practice.php");

      // identify element then click
      WebElement l = driver.findElement(By.xpath("//*[@id='headingOne']/button"));
      l.click();

      // identify all elements under tagname ul
      WebElement elements = driver.findElement(By.id("navMenus"));

      // identify first li element under ul then click
      WebElement element = elements.findElement(By.xpath("//li[1]/a"));
      element.click();

      WebElement e = driver.findElement(By.xpath("//*[@id='TextForm']/h1"));
      System.out.println("Text is: " + e.getText());

      // Closing browser
      driver.quit();
   }
}

Text is: Text Box

在上述示例中，我们首先使用嵌套定位符识别元素，然后获取文本并将其作为控制台消息： Text is: Text Box 。

最后，收到了消息 Process finished with exit code 0 ，表示代码成功执行。

但是，我们可以使用一种经过优化的技术来使用 xpath 或 css 定位符识别该元素，因为嵌套方法在性能方面并不好。

Syntax

WebDriver driver = new ChromeDriver();

// identify element with xpath
WebElement element = driver.findElement(By.xpath("//*[@id='navMenus']/li[1]/a"));

Example 2

package org.example;

import org.openqa.selenium.By;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.WebElement;
import org.openqa.selenium.chrome.ChromeDriver;
import java.util.concurrent.TimeUnit;

public class Finder {
   public static void main(String[] args) throws InterruptedException {

      // Initiate the Webdriver
      WebDriver driver = new ChromeDriver();

      // adding implicit wait of 15 secs
      driver.manage().timeouts().implicitlyWait(15, TimeUnit.SECONDS);

      // Opening the webpage
      driver.get("https://www.tutorialspoint.com/selenium/practice/selenium_automation_practice.php");

      // identify element then click
      WebElement l = driver.findElement(By.xpath("//*[@id='headingOne']/button"));
      l.click();

      // identify element with xpath
      WebElement element = driver.findElement(By.xpath("//*[@id='navMenus']/li[1]/a"));
      element.click();

      WebElement e = driver.findElement(By.xpath("//*[@id='TextForm']/h1"));
      System.out.println("Text is: " + e.getText());

      // Closing browser
      driver.quit();
   }
}

Text is: Text Box

在上述示例中，我们首先使用 xpath 定位符识别元素，然后获取文本并将作为控制台消息： Text is: Text Box 。

Identify Links Using the findElements Method

链接通过一个名为 href 的属性以及一个锚点标记名称来识别。

现在，让我们讨论一下在下面图片所示的网页中识别链接 Bad Request 。首先，右键单击页面，然后单击 Chrome 浏览器的“检查”按钮。然后，整个页面的相应 HTML 代码将会显示出来。要检查页面上的某个链接，请单击位于 HTML 代码顶部的左上方箭头，如下图中突出显示的那样。

一旦我们单击并将箭头指向错误请求超链接，其 HTML 代码就会显示出来，既反映出了锚点标记名称（称为“a”且包含在 <> 中），也反映出了属性 href。

让我们考虑上述页面的一个示例，我们首先会使用 findElements() 方法统计链接总数，然后会单击某个特定链接，比如 Bad Request 。在单击该链接后，我们将会得到消息 Link has responded with status 400 and status text Bad Request 。

Syntax

WebDriver driver = new ChromeDriver();
List<WebElement> totalLnks = driver.findElements(By.tagName("a") );

Example

package org.example;

import org.openqa.selenium.WebDriver;
import org.openqa.selenium.chrome.ChromeDriver;
import java.util.List;
import java.util.concurrent.TimeUnit;
import org.openqa.selenium.By;
import org.openqa.selenium.WebElement;

public class TotalLnks {
   public static void main(String[] args) throws InterruptedException {

      // Initiate the Webdriver
      WebDriver driver = new ChromeDriver() ;

      // adding implicit wait of 10 secs
      driver.manage().timeouts().implicitlyWait(10, TimeUnit.SECONDS);

      // Opening the webpage where we will count the links
      driver.get("https://www.tutorialspoint.com/selenium/practice/links.php" ) ;

      // Retrieve all links using locator By.tagName and storing in List
      List<WebElement> totalLnks = driver.findElements(By.tagName("a") );
      System.out.println( "Total number of links: " + totalLnks.size() ) ;

      // Running loop through list of web elements
      for( int j = 0; j < totalLnks.size(); j ++){
         if( totalLnks.get(j).getText().equalsIgnoreCase("Bad Request") ) {
            totalLnks.get(j).click() ;
            break ;
         }
      }

      // get text
      WebElement t = driver.findElement
         (By.xpath("/html/body/main/div/div/div[2]/div[4]"));
      System.out.println("Text is: " + t.getText());

      // Closing browser
      driver.quit();
   }
}

Total number of links: 42
Text is: Link has responded with status 400 and status text Bad Request

在上述示例中，我们统计了一个网页上的链接总数，并在控制台中收到了消息 - Total number of links: 42 ，然后在执行点击操作后收到了生成的文本 - Text is: Link has responded with status 400 and status text Bad Request 。

findElements Method with No Matching Element

让我们考虑一个示例并实现一段代码，在这种情况下，我们会看到 findElements() 方法返回的列表中可能包含 0 个元素（如果具有给定定位符值元素为 0 个的话）。

Example

package org.example;

import org.openqa.selenium.By;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.WebElement;
import org.openqa.selenium.chrome.ChromeDriver;
import java.util.List;
import java.util.concurrent.TimeUnit;

public class FindElement {
   public static void main(String[] args) throws InterruptedException {

      // Initiate the Webdriver
      WebDriver driver = new ChromeDriver();

      // adding implicit wait of 15 secs
      driver.manage().timeouts().implicitlyWait(15, TimeUnit.SECONDS);

      // Opening the webpage where we will identify element
      driver.get("https://www.tutorialspoint.com/selenium/practice/links.php");

      // Retrieve all elements using By.class name ul and storing in List
      List<WebElement> total = driver.findElements(By.tagName("input"));
      System.out.println( "Total number of elements with tagname input: " + total.size() ) ;

      //Closing browser
      driver.quit();
   }
}

Total number of elements with tagname input: 0

在上述示例中，我们统计了所有标记名为 input 的元素，并且在控制台中收到了消息 - Total number of elements with tagname input: 0 （因为没有匹配的元素）。

findElement Method with No Matching Element

让我们考虑一个示例并实现一段代码，在这种情况下，如果具有给定定位符值元素为 0 个，则 findElement() 方法会返回 NoSuchElement 异常。

Example

package org.example;

import org.openqa.selenium.By;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.WebElement;
import org.openqa.selenium.chrome.ChromeDriver;
import java.util.concurrent.TimeUnit;

public class FindElementWithException {
   public static void main(String[] args) throws InterruptedException {

      // Initiate the Webdriver
      WebDriver driver = new ChromeDriver();

      // adding implicit wait of 15 secs
      driver.manage().timeouts().implicitlyWait(15, TimeUnit.SECONDS);

      // Opening the webpage where we will identify element
      driver.get("https://www.tutorialspoint.com/selenium/practice/links.php");

      // Retrieve element using By.class name ul
      WebElement e = driver.findElement(By.className("ul"));
      System.out.println( "Element is : " + e);

      // Closing browser
      driver.quit();
   }
}

Exception in thread "main" org.openqa.selenium.NoSuchElementException: no such element:
   Unable to locate element: {"method":"css selector","selector":".ul"}
   (Session info: chrome=121.0.6167.160)
For documentation on this error, please visit:
https://www.selenium.dev/documentation/webdriver/troubleshooting/errors#no-such-element-exception

Process finished with exit code 1

在上述示例中，我们收到了 Process finished with exit code 1 ，表示代码执行失败。此外，我们还得到了 NoSuchElementException（由于网页上没有任何与匹配定位符值相符的元素）。

Difference between findElements and findElement Method

因此 findElement() 和 findElements() 的基本区别如下所示：

findElement() 方法返回 Web 元素，而 findElements() 方法返回 Web 元素列表。
如果不存在匹配项，findElement() 方法会抛出 NoSuchElementException，而 findElements() 方法会返回大小为 0 的列表。

activeElement Method

在网页上的所有元素中，我们可以使用 activeElement() 方法获取焦点所在的元素。

让我们以以上页面为例，我们首先在输入框中使用 sendKeys() 方法输入文本 Selenium 。然后使用 Selenium activeElement() 方法获取焦点元素的属性值（在将驱动程序上下切换到焦点元素后）。

Example

package org.example;

import org.openqa.selenium.By;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.WebElement;
import org.openqa.selenium.chrome.ChromeDriver;
import java.util.concurrent.TimeUnit;

public class HandlingActivesElement {
   public static void main(String[] args) throws InterruptedException {

      // Initiate the Webdriver
      WebDriver driver = new ChromeDriver();

      // adding implicit wait of 15 secs
      driver.manage().timeouts().implicitlyWait(15, TimeUnit.SECONDS);

      // launching URL
      driver.get("https://www.tutorialspoint.com/selenium/practice/text-box.php");

      // Identify the input box with xpath locator
      WebElement e = driver.findElement(By.xpath("//*[@id='fullname']"));

      // enter text in input box
      e.sendKeys("Selenium");

      // Get the value of element in focus after switching driver context
      String a = driver.switchTo().activeElement().getAttribute("value");
      System.out.println("Value entered: " + a);

      // Closing browser
      driver.quit();
   }
}

Value entered: Selenium

在上面的示例中，我们首先在输入框中输入文本 Value entered: Selenium ，并且还使用消息在控制台中检索了焦点中当前元素的值 - Chrome is being controlled by automated test software （即输入的值）。

Conclusion

这就总结了我们对 Selenium Webdriver Finders 教程的全面讲解。我们从描述 findElement 方法开始，使用嵌套的 findElements 识别元素，使用 findElements 方法识别链接，没有匹配元素的 findElements 方法，没有匹配元素的 findElement 方法，findElements 和 findElement 方法之间的差异，activeElement 方法，以及示例来说明如何在 Selenium Webdriver 中使用查找器。这让你对 Selenium Webdriver Finders 有了深入的了解。明智的做法是继续练习你学到的知识，并探索与 Selenium 相关的内容，以加深你的理解并拓展你的视野。