Selenium 网络驱动程序 Java 程序范例

由： Krishna 伦塔 Krishna 伦塔
Hours 更新

⚡ 智能摘要

Selenium 网络驱动程序 Java 程序示例将引导您完成第一个端到端自动化脚本。 Lessons 涵盖环境设置、定位元素、发送输入、导航、验证、等待、异常处理以及可靠的 WebDriver 测试的最佳实践。

  • ⚙️ 环境设置： 安装 Java, Eclipse 或者 IntelliJ，进行配置 Selenium 库，并为您的浏览器版本选择正确的驱动程序二进制文件。
  • 🧭 元素定位器： 使用 ID、名称、类、XPath、CSS 选择器和 linkText 来跨浏览器和版本稳定地识别元素。
  • ⌨️ 操作和输入： WebDriver 支持点击、发送按键、提交、选择下拉菜单和键盘事件，实现完整的用户风格交互。
  • ⏳ 智能等待： 用 ExpectedConditions 驱动的隐式、显式和流畅的等待来替换 Thread.sleep，以消除不稳定的测试。
  • ???? 异常处理： 捕获 NoSuchElementException、TimeoutException 和 StaleElementReferenceException，以保持自动化套件的弹性。
  • 🤖 AI测试生成： AI 助手可以生成 WebDriver 脚本模板，建议定位器，并在 DOM 更改时自动修复选择器。
阅读更多

Selenium 网络驱动程序 Java 会议议程

Selenium Java 例如：

使用 Java 利用我们在上一个教程中创建的类“myclass”，让我们尝试创建一个 WebDriver 脚本，该脚本将：

第三步： 取 Mercury 旅游主页
第三步： 核实其标题
第三步： 打印出比较结果
第三步： 在结束整个程序之前将其关闭。

Selenium WebDriver 示例 Code

以下是上述场景所呈现的逻辑的实际 WebDriver 代码

package newproject;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.firefox.FirefoxDriver;
//comment the above line and uncomment below line to use Chrome
//import org.openqa.selenium.chrome.ChromeDriver;
public class PG1 {


    public static void main(String[] args) {
        // declaration and instantiation of objects/variables
    	System.setProperty("webdriver.gecko.">driver","C:\\geckodriver.exe");
		WebDriver driver = new FirefoxDriver();
		//comment the above 2 lines and uncomment below 2 lines to use Chrome
		//System.setProperty("webdriver.chrome.">driver","G:\\chromedriver.exe");
		//WebDriver driver = new ChromeDriver();
    	
        String baseUrl = "https://demo.guru99.com/test/newtours/";
        String expectedTitle = "Welcome: Mercury Tours";
        String actualTitle = "";

        // launch Fire fox and direct it to the Base URL
        driver.get(baseUrl);

        // get the actual value of the title
        actualTitle = driver.getTitle();

        /*
         * compare the actual title of the page with the expected one and print
         * the result as "Passed" or "Failed"
         */
        if (actualTitle.contentEquals(expectedTitle)){
            System.out.println("Test Passed!");
        } else {
            System.out.println("Test Failed");
        }
       
        //close Fire fox
        driver.close();
    }

}

注意：开始 Firefox 35，您需要使用 Mozilla 创建的 gecko 驱动程序才能使用 Web Driver。 Selenium 3.0，gecko 和 Firefox 存在兼容性问题，正确设置它们可能是一项艰巨的任务。如果代码不起作用，请降级到 Firefox 版本 47 或更低版本。或者，您也可以在 Chrome 上运行脚本。 Selenium Chrome 开箱即用。你只需要更改 3 行代码即可使你的脚本与 Chrome 兼容，或者 Firefox

解释代码

导入包

首先，您需要导入以下两个包：

  1. org.openqa.selenium.*– 包含实例化加载特定驱动程序的新浏览器所需的 WebDriver 类
  2. org.openqa.selenium.firefox。Firefox驱动器 – 包含 Firefox需要实例化驱动程序类 Firefox特定驱动程序到由 WebDriver 类实例化的浏览器上

如果您的测试需要更复杂的操作，例如访问另一个类、截取浏览器屏幕截图或操作外部文件，那么您肯定需要导入更多包。

实例化对象和变量

通常情况下，这就是驱动程序对象实例化的方式。

WebDriver driver = new FirefoxDriver();

A Firefox没有参数的驱动类意味着默认 Firefox 个人资料将由我们的 Java 程序。默认 Firefox 配置文件类似于启动 Firefox 处于安全模式（未加载任何扩展）。

为了方便起见，我们保存了基地 URL 以及预期标题作为变量。

启动浏览器会话

WebDriver 的 得到（） 该方法用于启动一个新的浏览器会话并将其定向到 URL 你将其指定为其参数。

driver.get(baseUrl);

获取实际的页面标题

WebDriver 类具有 获取标题() 始终用于获取当前加载页面的页面标题的方法。

actualTitle = driver.getTitle();

比较预期值和实际值

这部分代码只是使用了一个基本的 Java if-else 结构来比较实际标题与预期标题。

if (actualTitle.contentEquals(expectedTitle)){
            System.out.println("Test Passed!");
        } else {
            System.out.println("Test Failed");
        }

终止浏览器会话

“”关（）”方法用于关闭浏览器窗口。

driver.close();

终止整个程序

如果您使用此命令时没有先关闭所有浏览器窗口，您的整个 Java 程序将结束，但浏览器窗口保持打开状态。

System.exit(0);

运行测试

有两种方式可以执行代码 Eclipse IDE。

  1. On Eclipse菜单栏中，点击 运行 > 运行。
  2. 媒体中心 Ctrl + F11键 运行整个代码。

运行测试

如果你做的一切都正确， Eclipse 将输出“测试通过！”

运行测试

相关文章

定位 GUI 元素

在 WebDriver 中定位元素是通过使用“查找元素（通过。定位器（））”方法。代码的“定位器”部分与之前讨论过的任何定位器相同 Selenium IDE 这些教程的章节。事实上，建议您使用 IDE 定位 GUI 元素，一旦成功识别，就将代码导出到 WebDriver。

这里是一个 Selenium 以下示例代码演示如何通过 ID 定位元素。以 Facebook 为例。 URL.

package newproject;
import org.openqa.selenium.By;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.firefox.FirefoxDriver;

public class PG2 {
    public static void main(String[] args) {
    	System.setProperty("webdriver.gecko.">driver","C:\\geckodriver.exe");
    	WebDriver driver = new FirefoxDriver();
        String baseUrl = "http://www.facebook.com";
        String tagName = "";
        
        driver.get(baseUrl);
        tagName = driver.findElement(By.id("email")).getTagName();
        System.out.println(tagName);
        driver.close();
        System.exit(0);
}
}

我们所使用的 获取标签名() 方法是trac这段代码应该能够正确识别 id 为“email”的元素的标签名称“input”，并将其打印出来。 Eclipse的控制台窗口。

定位 GUI 元素

定位元素摘要

变异 描述 样本
按.className 根据“class”属性的值查找元素 findElement（By.className（“someClassName”））
通过.cssSelector 根据驱动程序的底层 CSS 选择器引擎查找元素 findElement（By.cssSelector（“input#email”））
獲得.id 根据元素“id”属性的值来定位元素 findElement（By.id（“someId”））
 
通过.linkText 根据显示的精确文本查找链接元素 findElement（By.linkText（"注册"））
 
按名字 根据“name”属性的值定位元素 findElement（By.name（“someName”））
 
通过.partialLinkText 定位包含给定链接文本的元素 查找元素（By.partialLinkText（"REG"））
 
按标签名称 根据标签名称定位元素 findElement（通过.tagName（ “div”））
 
通过.xpath 通过 XPath 定位元素 findElement(By.xpath(“//html/body/div/table/tbody/tr/td[2]/table/
tbody/tr[4]/td/table/tbody/tr/td[2]/table/tbody/tr[2]/td[3]/ form/table/tbody/tr[5]”))

使用 findElement(By.cssSelector()) 的注意事项

By.cssSelector() 不支持“包含”功能。考虑 Selenium 下面的 IDE 代码 –

使用 findElement(By.cssSelector()) 的注意事项

In Selenium IDE 中，整个测试通过。然而在 Selenium 下面的 WebDriver 脚本，相同的测试产生了错误，因为 WebDriver 在 By.cssSelector() 方法中使用时不支持“contains”关键字。

使用 findElement(By.cssSelector()) 的注意事项

常用命令

实例化 Web 元素

每次访问特定元素时，我们无需使用冗长的“driver.findElement(By.locator())”语法，而是可以为其实例化 WebElement 对象。WebElement 类包含在“org.openqa.selenium.*”包中。

实例化 Web 元素

点击元素

点击可能是与网络元素交互的最常见方式。 click() 方法用于模拟单击任意元素。以下 Selenium Java 这个例子显示了 click() 被用来点击 Mercury 旅游的“登录”按钮。

点击元素

使用click（）方法时必须注意以下几点。

  • 它不接受任何参数/论据。
  • 如果适用，该方法将自动等待新页面加载。
  • 被点击的元素必须可见（高度和宽度不能等于零）。

获取命令

获取命令可获取有关页面/元素的各种重要信息。以下是您必须熟悉的一些重要“获取”命令。

命令 用法
得到（）

样品用法：
  • 它会自动打开一个新的浏览器窗口并获取您在括号内指定的页面。
  • 它是 Selenium IDE 的“打开”命令。
  • 参数必须是 串 目的。
获取标题()

样品用法：
  • 不需要参数
  • 获取当前页面的标题
  • 前导和尾随空格被修剪
  • 如果页面没有标题，则返回空字符串
获取页面源()

样品用法：
  • 不需要参数
  • 以字符串值形式返回页面的源代码
获取当前网址()

样品用法：
  • 不需要参数
  • 获取表示当前状态的字符串 URL 浏览器正在查看
getText（）

样品用法：
  • 获取指定元素的内部文本

导航命令

这些命令允许您刷新、进入和在不同的网页之间来回切换。

导航（）

样品用法：
  • 它会自动打开一个新的浏览器窗口并获取您在括号内指定的页面。
  • 它的作用和 get() 方法。
导航（）。刷新（）

样品用法：
  • 不需要参数。
  • 它刷新当前页面。
导航（）。返回（）

样品用法：
  • 不需要参数
  • 带您返回浏览器历史记录中的上一页。
导航（）。前进（）

样品用法：
  • 不需要参数
  • 使您在浏览器的历史记录中向前移动一页。

关闭并退出浏览器 Windows

关（）

样品用法：
  • 不需要参数
  • 它只关闭 WebDriver 当前控制的浏览器窗口。
放弃（）

样品用法：
  • 不需要参数
  • 它关闭 WebDriver 打开的所有窗口。

关闭并退出浏览器 Windows

为了清楚地说明 close() 和 quit()，尝试执行下面的代码。它使用一个网页，该网页在页面加载时自动弹出一个窗口，退出后打开另一个窗口。

关闭并退出浏览器 Windows

请注意，只有父浏览器窗口被关闭，而不是两个弹出窗口。

关闭并退出浏览器 Windows

但是如果你使用 quit()，所有窗口都会关闭——而不仅仅是父窗口。尝试运行下面的代码，你会注意到上面的两个弹出窗口也会自动关闭。

package newproject;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.firefox.FirefoxDriver;

public class PG3 {
    public static void main(String[] args) {
    	System.setProperty("webdriver.gecko.">driver","C:\\geckodriver.exe");
    	WebDriver driver = new FirefoxDriver();
        driver.get("http://www.popuptest.com/popuptest2.html");
        driver.quit();  // using QUIT all windows will close
    }
}

在框架之间切换

要访问框架中的 GUI 元素，我们首先应指示 WebDriver 先将焦点放在框架或弹出窗口上，然后才能访问其中的元素。让我们以网页为例 https://demo.guru99.com/selenium/deprecated.html

在框架之间切换

此页面有 3 个框架，其“name”属性如上所示。我们希望访问上面用黄色圈出的“已弃用”链接。为此，我们必须首先指示 WebDriver 使用 “switchTo().frame()” 方法。我们将使用框架的名称属性作为“frame()”部分的参数。

package newproject;
import org.openqa.selenium.By;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.firefox.FirefoxDriver;
public class PG4 {
	  public static void main(String[] args) {
		  	System.setProperty("webdriver.gecko.">driver","C:\\geckodriver.exe");  
		  	WebDriver driver = new FirefoxDriver();
	        driver.get("https://demo.guru99.com/selenium/deprecated.html");
	        driver.switchTo().frame("classFrame");
	        driver.findElement(By.linkText("Deprecated")).click();
	        driver.close(); 
	    }
}

执行此代码后，你会看到“classFrame”框架被带到“Deprecated API”页面，这意味着我们的代码成功访问了“Deprecated”链接。

在弹出窗口之间切换 Windows

WebDriver 允许显示类似警报的弹出窗口，与 Selenium IDE。要访问警报内的元素（例如它包含的消息），我们必须使用 "switchTo().alert()" 方法。在下面的代码中，我们将使用此方法访问警告框，然后使用 "getText()" 方法，然后使用 "switchTo().alert().accept()" 方法。

首先，前往 https://output.jsbin.com/usidix/1 然后手动点击那里的“Go！”按钮，亲自查看消息文本。

在弹出窗口之间切换 Windows

让我们看看 Selenium 执行此操作的示例代码-

package mypackage;

import org.openqa.selenium.By;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.firefox.FirefoxDriver;

public class myclass {

    public static void main(String[] args) {
    	System.setProperty("webdriver.gecko.">driver","C:\\geckodriver.exe");
        WebDriver driver = new FirefoxDriver();
        String alertMessage = "";

        driver.get("http://jsbin.com/usidix/1");
        driver.findElement(By.cssSelector("input[value=\"Go!\"]")).click();
        alertMessage = driver.switchTo().alert().getText();
        driver.switchTo().alert().accept();
       
        System.out.println(alertMessage);
        driver.quit();
       
    }
}

点击 Eclipse 控制台，注意打印的警告信息是：

在弹出窗口之间切换 Windows

等待

有两种等待。

  1. 隐式等待——用于设置整个程序的默认等待时间
  2. 显式等待 – 用于仅设置特定实例的等待时间

隐式等待

  • 与显式等待相比，其编码更简单。
  • 它通常在代码的实例部分声明。
  • 您只需要导入一个额外的包。

要开始使用隐式等待，您必须将此包导入到您的代码中。

隐式等待

然后在代码的实例化部分添加以下内容。

隐式等待

显式等待

使用 WebDriverWait 和 ExpectedCondition 类进行显式等待. 对于以下 Selenium WebDriver 示例，我们将等待最多 10 秒钟，让 id 为“username”的元素变为可见，然后再继续执行下一个命令。步骤如下。

第三步：

导入这两个包：

显式等待

第三步：

声明一个 WebDriverWait 变量。在此示例中，我们将使用“myWaitVar”作为变量的名称。

显式等待

第三步：

在需要显式等待的部分使用 myWaitVar 和 ExpectedConditions。在本例中，我们将在“用户名”上使用显式等待（Mercury 我们可以在输入框中输入“教程”一词，然后输入“旅游主页”

显式等待

医美问题

以下方法用于条件语句和 LOO 语句中。ping 运营 -

  • 已启用（） 当您想要在执行命令之前验证某个元素是否启用时使用。

条件 isEnabled()

  • 是否显示（） 当你想在执行命令之前验证某个元素是否显示时使用。

条件 isDisplayed()

  • 被选中（） 用于验证某个 复选框、单选按钮或下拉框中的选项 已选定。 它对其他元素不起作用。

条件 isSelected()

使用 ExpectedConditions

ExpectedConditions 类提供了更广泛的条件，您可以将其与 WebDriverWait 的 till() 方法结合使用。

以下是一些最常见的 ExpectedConditions 方法。

  • 警报是否存在（） – 等待直到显示警告框。

使用 ExpectedConditions alertIsPresent()

  • 可点击元素（） – 等待元素可见，同时启用。示例 Selenium Code 下面的代码会等到 id=”username” 的元素变为可见且启用后，再将该元素赋值为名为“txtUserName” 的 WebElement 变量。

使用 ExpectedConditions

  • 帧可用并切换到它（） – 等待直到给定的帧可用，然后自动切换到它。

使用 ExpectedConditions elementToBeClickable()

捕获异常

使用 isEnabled()、isDisplayed() 和 isSelected() 时，WebDriver 假定该元素已存在于页面上。否则，它将抛出 没有这样的元素异常为了避免这种情况，我们应该使用try-catch块，这样程序就不会被中断。

WebElement txtbox_username = driver.findElement(By.id("username"));
try{
        if(txtbox_username.isEnabled()){
            txtbox_username.sendKeys("tutorial");
        }
    }

catch(NoSuchElementException nsee){
            System.out.println(nsee.toString());
 }

如果您使用显式等待，那么您应该捕获的异常类型是“TimeoutException”。

捕获异常

常见问题

安装 JDK 和 IDE，例如： Eclipse 或者 IntelliJ， Selenium Java 库以及匹配的浏览器驱动程序。构建自动化工具，例如 Maven 或 Gradle 简化依赖关系管理。

AI 可以自动修复定位器，根据用户故事生成测试用例，并识别不稳定的测试。类似这样的平台 TestimMabl 和 Applitools 都嵌入了人工智能，以实现更智能的创作、执行和视觉验证。

是的。GitHub Copilot、Cursor 和 JetBrains 人工智能生成 Java Selenium 脚本由纯语言步骤构成，包括等待、断言和页面对象。它们大大减少了新测试场景的样板代码。

findElement 返回第一个匹配的 WebElement，否则抛出 NoSuchElementException 异常。findElements 返回所有匹配项的列表，如果没有找到匹配项，则返回空列表，且不会抛出异常。

Thread.sleep 会暂停固定时长，而不管页面状态如何，这会降低快速运行的速度，并导致慢速运行失败。使用带有 ExpectedConditions 的 WebDriverWait 可以仅在需要时等待。

Selenium 支持 ChromeDriver 和 GeckoDriver FirefoxEdgeDriver、SafariDriver 和 IEDriverServer。 Selenium 版本 4 中的管理器会自动下载正确的驱动程序。

配置 ChromeOptions 或 Firefox选项对象设置了 setAcceptInsecureCerts(true)。这会告诉浏览器忽略无效证书，以便 WebDriver 会话可以继续进行。

WebDriverManager 会自动下载并配置适用于您已安装浏览器版本的正确浏览器驱动程序二进制文件，从而消除手动驱动程序维护，并减少新贡献者的设置时间。

总结一下这篇文章：