当前位置： 首页 > news >正文

【软件测试学习day6】WebDriver常用的API

news 2025/7/4 16:48:49

目录

1. WebDriver API

1.1 元素的定位

1.2 id 定位

1.3 name 定位

1.4 class name 定位

1.5 Xpath 定位

1.6 link text 定位

1.6.1 精确匹配

1.6.2 模糊匹配

2. 操作测试对象

2.1 点击与输入

2.2 submit 提交按钮

2.3 text 获取元素文本

2.4 clear 清除

2.5 等待

2.5.1 强制等待

2.5.2 智能等待

2.5.2.1 显式等待

2.5.2.2 隐式等待 

2.6 打印信息

2.7 浏览器操作

3. 键盘事件

4. 鼠标事件

5. 定位一组元素

6. 下拉框操作

7. alert弹窗操作

8. 上传文件操作

9. 关闭和退出浏览器

10. 窗口切换

11. 截图

1. WebDriver API

想要实现自动化测试，就需要知道所测试对象在的位置，因此可以通过元素的标签等属性来对这些对象进行定位。获取这些属性可通过 F12 或 右击检查。

1.1 元素的定位

常用的元素定位有：id、name、class name、link text、partial link text、tag name、xpath、css selector。

如何找到 id 或其他属性，点击搜索框右键检查或者按 F12 ，在元素里面找到对应的属性即可。

代码层面则通过 WebDriver 底下的 findElement 方法来找到元素。

1.2 id 定位

功能：通过 id 来找到该元素对应的位置。

语法：findElement(By.cssSelector("id名"))。

.sendKeys()：在对应的输入框中输入文本。

public class Main {public static void main(String[] args) {test01();}private static void test01() {ChromeOptions options = new ChromeOptions();// 允许所有请求options.addArguments("---remote-allow-origins=*");WebDriver webDriver = new ChromeDriver(options);// 进入下方网站webDriver.get("https://www.baidu.com/");// idWebElement element = webDriver.findElement(By.cssSelector("#kw"));// 输入信息element.sendKeys("id测试");}
}

1.3 name 定位

语法：webDervier.findElement(By.name("name名"))

1.4 class name 定位

语法： findElement(By.cssSelector(".类名")) 

1.5 Xpath 定位

语法：.findElement(By.xpath("Xpath路径")) 。

绝对路径：

  • /html/head/title

相对路径：

  • 相对路径+索引：//form/span[1]/input（查找第一个span下的 input 标签）
  • 相对路径+属性：//input[@class="s_ipt"]（查找类名为 s_ipt 的标签）
  • 相对路径+通配符：//*[@*="s_ipt"]（查找所有名为 s_ipt 的标签）
  • 相对路径+文本匹配：//a[text()="文本"]（查找 a 标签含有文本的标签）

直接获取 Xpath 定位方式如下：

public class Main {public static void main(String[] args) {test01();}private static void test01() {ChromeOptions options = new ChromeOptions();// 允许所有请求options.addArguments("---remote-allow-origins=*");WebDriver webDriver = new ChromeDriver(options);// 进入下方网站webDriver.get("https://www.baidu.com/");// XpathWebElement element = webDriver.findElement(By.xpath("//*[@id=\"kw\"]"));// 输入信息element.sendKeys("Xpath测试");}
}

1.6 link text 定位

link text 定位为两种基于链接文本的定位，主要有两种：精确匹配 和 模糊匹配。

1.6.1 精确匹配

功能：通过链接的完整可见文本进行精确匹配。

语法：WebElement element = driver.findElement(By.linkText("完整链接文本"));

1.6.2 模糊匹配

功能：通过链接的部分可见文本进行模糊匹配（只要包含指定子串即可）。

语法：WebElement element = driver.findElement(By.partialLinkText("部分链接文本"));

2. 操作测试对象

webdriver 中比较常见操作对象的方法有：click（点击事件）、send_keys（在对象上模拟按键输入）、clear（清除）、submit（提交表单）、text（获取文本对象） 。

2.1 点击与输入

语法：输入：.sendKeys()，点击：.click()。 

public class Main {public static void main(String[] args) {test01();}private static void test01() {ChromeOptions options = new ChromeOptions();// 允许所有请求options.addArguments("---remote-allow-origins=*");WebDriver webDriver = new ChromeDriver(options);// 进入下方网站webDriver.get("https://www.baidu.com/");// Xpath 路径WebElement element = webDriver.findElement(By.xpath("//*[@id=\"kw\"]"));// 输入信息element.sendKeys("输入框测试");// 点击提交按钮webDriver.findElement(By.cssSelector("#su")).click();}
}

2.2 submit 提交按钮

语法：.submit()

  • 如果点击的元素放在 form 标签中，此时使用 submit 实现的效果和 click 是一样的。
  • 如果点击的元素放在非 form 标签中，此时使用 submit 报错。

2.3 text 获取元素文本

语法：.getText() 或 .getAttribute()。

.getText()获取元素的可见文本内容（用户实际看到的文本）。String按钮文字、链接文本、段落内容、表格单元格文本等。
.getAttribute()获取元素的指定属性值（如href、value、class等，或自定义属性）。String获取输入框的默认值、隐藏字段的值、动态生成的属性、自定义data-*属性等。

当我们需要获取到网页中的某个文本时可通过 .getText() 来获取。 如想要访问下图文本：

        ChromeOptions options = new ChromeOptions();// 允许所有请求options.addArguments("---remote-allow-origins=*");WebDriver webDriver = new ChromeDriver(options);// 进入下方网站webDriver.get("https://www.baidu.com/");// 通过类来获取WebElement element = webDriver.findElement(By.cssSelector(".title-content-title"));String inp = element.getText();System.out.println(inp);

如果要获取标签中的文本可采用 .getAttribute("标签名") ，如获取按钮中的文本：

   ChromeOptions options = new ChromeOptions();// 允许所有请求options.addArguments("---remote-allow-origins=*");WebDriver webDriver = new ChromeDriver(options);// 进入下方网站webDriver.get("https://www.baidu.com/");// 通过类来获取String buttonValue = webDriver.findElement(By.cssSelector("#su")).getAttribute("value");if (buttonValue.equals("百度1下")) {System.out.println("测试通过");}else {System.out.println(buttonValue);

2.4 clear 清除

功能：将字段进行清除

语法：.clear();

运行 Java 代码，自动给搜索 “测试清除”，并搜索后清空搜索栏中的 “测试清除” 字段。代码如下：

​
public class Main {public static void main(String[] args) {test01();}private static void test01() {ChromeOptions options = new ChromeOptions();// 允许所有请求options.addArguments("---remote-allow-origins=*");WebDriver webDriver = new ChromeDriver(options);webDriver.get("https://www.baidu.com/");// 找到搜索框并输入 测试清除 字段webDriver.findElement(By.cssSelector("#kw")).sendKeys("测试清除");// 点击了百度一下按钮webDriver.findElement(By.cssSelector("#su")).click();// 清空百度搜索框中的数据webDriver.findElement(By.cssSelector("#kw")).clear();}
}​

2.5 等待

2.5.1 强制等待

语法：sleep()，例：强制等待 2 秒 sleep(2000);。

功能：使程序中某一时刻强制等待。

2.5.2 智能等待

智能等待分为 显式等待 和 隐式等待。

2.5.2.1 显式等待

功能：针对特定元素或条件设置灵活的等待逻辑，支持自定义验证条件。

特点：全局生效即对所有的 WebDriver 操作生效。

WebDriverWait wait = new WebDriverWait(driver, Duration.ofSeconds(10));
WebElement element = wait.until(ExpectedConditions.visibilityOfElementLocated(By.id("dynamic-element")));
2.5.2.2 隐式等待 

功能：为所有的 findElement() 或 findElements() 设置全局超时等待。

特点：对特定的元素或操作生效。

WebDriver driver = new ChromeDriver();
driver.manage().timeouts().implicitlyWait(Duration.ofSeconds(10)); // 全局等待10秒

2.6 打印信息

打印 url 使用 .getCurrentUrl()  。

打印 title 使用 .getTitle(）。

        ChromeOptions options = new ChromeOptions();// 允许所有请求options.addArguments("---remote-allow-origins=*");WebDriver webDriver = new ChromeDriver(options);// 进入下方网站webDriver.get("https://www.baidu.com/");// 获取当前页面的 urlString url = webDriver.getCurrentUrl();// 获取当前页面的 titleString title = webDriver.getTitle();System.out.println("当前页面的url="+url );System.out.println("当前页面的title="+title);

2.7 浏览器操作

浏览器操作主要有前进、后退、刷新、滚动条、浏览器最大化等，本期讲解以下几种：

  • 前进：webDriver 底下的 navigate().forward() 方法
  • 后退：webDriver 底下的 navigate().back() 方法
  • 刷新：WebDriver 底下的 navigate().refresh() 方法
  • 滚动条：WebDriver.executeScript() 方法（需将 webDriver 类型转换为 JavaScriptExecutor ）
        WebDriver webDriver = new ChromeDriver();// 打开以下网站webDriver.get("https://www.baidu.com/");// 搜索框输入111webDriver.findElement(By.cssSelector("#kw")).sendKeys("111");// 提交webDriver.findElement(By.cssSelector("#su")).click();// 浏览器后退sleep(2000);// 等待2秒webDriver.navigate().back();sleep(2000);// 等待2秒// 浏览器刷新webDriver.navigate().refresh();sleep(2000); // 等待2秒// 浏览器前进webDriver.navigate().forward();sleep(2000); // 等待2秒// 滚动条((JavascriptExecutor)webDriver).executeScript("document.documentElement.scrollTop=10000");sleep(2000); // 等待2秒// 浏览器最大化webDriver.manage().window().fullscreen();sleep(2000); // 等待2秒// 设置浏览器窗口大小webDriver.manage().window().setSize(new Dimension(600,1000));sleep(2000); // 等待2秒

3. 键盘事件

当我们需要将某个事件进行全选、剪切、复制、粘贴时就会用到键盘事件，如下代码。

webDriver.findElement(By.cssSelector("#kw")).sendKeys(Keys.CONTROL,"A");

其中 A 代表全选，X 代表剪切，V 代表粘贴。

4. 鼠标事件

        // 找到图片WebElement webElement = webDriver.findElement(By.cssSelector(".cos-image-video-mask_4G07f"));// 鼠标右击Actions actions = new Actions(webDriver);sleep(2000);actions.moveToElement(webElement).contextClick().perform();

5. 定位一组元素

场景：有一组 input 标签有单选框（radio）、复选框（checkbox），是单选框就点击。

        WebDriver webDriver = new ChromeDriver();// 打开你要访问的路径webDriver.get("");// 假设你要访问的是一组 input 标签List<WebElement> webElements = webDriver.findElements(By.cssSelector("input"));// 遍历这组数据for (int i = 0; i < webElements.size(); i++) {// 判断是否为复选框是则点击if (webElements.get(i).getAttribute("type").equals("radio")) {webElements.get(i).click();}else {}}

6. 下拉框操作

        WebDriver webDriver = new ChromeDriver();webDriver.get("对应的网址");WebElement webElement = webDriver.findElement(By.cssSelector("对应的class或id"));Select select = new Select(webElement);select.selectByIndex(0);// 选择第一个select.selectByValue("对应的value值");// 该 value 对应的选择框

7. alert弹窗操作

alert 弹框取消：webDriver.switchTo().alert().dissmiss();

alert 弹框输入信息：webDriver.switchTo().alert().sendKeys();

alert 弹框确认：webDriver.switchTo().alert().accept();

        WebDriver webDriver = new ChromeDriver();webDriver.get("");// 点击按钮webDriver.findElement(By.cssSelector("button")).click();sleep(2000);// alert 弹窗取消webDriver.switchTo().alert().dismiss();// 再次点击按钮webDriver.findElement(By.cssSelector("button")).click();// alert 弹窗内输入内容webDriver.switchTo().alert().sendKeys("你好");sleep(2000);// alert 弹窗确认webDriver.switchTo().alert().accept();

8. 上传文件操作

        WebDriver webDriver = new ChromeDriver();webDriver.get("");// 想要访问的地址webDriver.findElement(By.cssSelector("input")).sendKeys("文件路径");

9. 关闭和退出浏览器

关闭：.close();

退出：.quit();

        WebDriver webDriver = new ChromeDriver();webDriver.get("https://www.baidu.com/");webDriver.findElement(By.cssSelector("#s-top-left > a:nth-child(1)")).click();sleep(2000);webDriver.quit(); //退出浏览器webDriver.close(); //关闭浏览器

两者区别：

quit 退出整个浏览器，close 关闭当前页面（跳转之前的页面）。

quit 清空缓存，close 不会清空缓存。

10. 窗口切换

窗口切换会用到句柄，通过 .getWindowHandles() 就能获取到，通过句柄测试脚本就可对窗口进行打开、关闭或切换。

        WebDriver webDriver = new ChromeDriver();webDriver.get("https://www.baidu.com/");webDriver.findElement(By.cssSelector("#s-top-left > a:nth-child(1)")).click();sleep(2000);// 获取到所有窗口的句柄Set<String> handles = webDriver.getWindowHandles();String target_handle = "";for (String handle:handles) {target_handle = handle;}webDriver.switchTo().window(target_handle);sleep(2000);webDriver.findElement(By.cssSelector("#ww")).sendKeys("新闻联播");webDriver.findElement(By.cssSelector("#s_btn_wr")).click();

其中 .switchTo().window(“句柄”) 可对多窗口/页面进行切换和操作。

11. 截图

需要在 idea 中引入 common-io 依赖。

<dependency><groupId>commons-io</groupId><artifactId>commons-io</artifactId><version>2.11.0</version>
</dependency>

实现：

  • Selenium WebDriver通过 TakesScreenshot接口提供截图功能
  • 通过 getScreenshotAs() 结合Robot类或AShot库（第三方工具）截取特定DOM元素，而非全屏。
  • 将 webDriver 强转为 TakesScreenshot 类型，并使用 .getScreenshotAs() 方法，再写入到本地磁盘。 
        WebDriver webDriver = new ChromeDriver();webDriver.get("https://www.baidu.com/");webDriver.findElement(By.cssSelector("#kw")).sendKeys("软件测试");webDriver.findElement(By.cssSelector("#su")).click();sleep(2000);// 截图File file = ((TakesScreenshot)webDriver).getScreenshotAs(OutputType.FILE);FileUtils.copyFile(file,new File("D://test.png"));

效果： 

http://www.xdnf.cn/news/329941.html

相关文章：

  • Java后端开发day43--IO流（三）--缓冲流转换流序列化流
  • 如何在本地测试网站运行情况
  • Kubernetes生产实战：容器内无netstat时的7种端口排查方案
  • 如何理解参照权
  • 如何设置飞书多维表格，可以在扣子平台上使用
  • Python办公自动化应用（三）
  • 备注在开发中的重要作用
  • MySQL数据库高可用（MHA）详细方案与部署教程
  • 国标GB28181视频平台EasyGBS打造电力行业变电站高效智能视频监控解决方案
  • 统计匹配的二元组个数 - 华为OD机试真题(A卷、JavaScript题解)
  • 宝塔面板，删除项目后还能通过域名进行访问
  • 从人脸扫描到实时驱动，超写实数字分身技术解析
  • Go语言中的并发编程--详细讲解
  • 【赵渝强老师】TiDB的备份恢复策略
  • 将本地项目提交到新建的git仓库
  • 【性能工具】一种简易hook bitmap创建的插件使用
  • Docker + Watchtower 实现容器自动更新：高效运维的终极方案
  • 算法研习：最大子数组和问题深度剖析
  • YOLO-POSE 姿态扩充
  • CUDA：out of memory的解决方法（实测有效）
  • 心智领航・数启未来 | AI数字化赋能精神心理医疗学术大会重磅来袭，5月10日广州附医华南医院开启智慧对话！
  • 【C++贪心】P9344 去年天气旧亭台|普及
  • Spark处理过程-转换算子和行动算子
  • NumPy 2.x 完全指南【一】简介
  • 混淆矩阵（Confusion Matrix）
  • Qt开发经验 --- 避坑指南（5）
  • python打卡day18
  • Spring MVC中跨域问题处理
  • 把一个过大的文件夹分成若干个 ZIP 分卷
  • 雅努斯问题（Janus Problem）及解决方案