一、Selenium 自动化
1、什么是Selenium？
Selenium是web应用中基于UI的自动化测试框架。
2、Selenium的特点？
支持多平台、多浏览器、多语言。
3、自动化工作原理？
通过上图，我们可以注意到3个角色，下面具体讲解一下：
- 自动化脚本：对于java来说也就是使用WebDriver API编写的测试脚本。用于发送给浏览器驱动。
- 浏览器的驱动（browser driver）：每个浏览器都有自己的驱动，均以exe文件形式存在。比如谷歌的chromedriver.exe、火狐的geckodriver.exe、IE的IEDriverServer.exe。它来解析这些自动化测试的代码，解析后把它们发送给浏览器。
- 浏览器：浏览器当然就是我们很熟悉的常用的各种浏览器。执行浏览器驱动发来的指令，并最终完成工程师想要的操作。
结合上图，我们可以进一步理解：
- 对于每一条Selenium脚本，一个http请求会被创建并且发送给浏览器的驱动。
- 浏览器驱动中包含了一个HTTP Server，用来接收这些http请求。
- HTTP Server接收到请求后根据请求来具体操控对应的浏览器。
- 浏览器执行具体的测试步骤。
- 浏览器将步骤执行结果返回给HTTP Server。
- HTTP Server又将结果返回给Selenium的脚本，如果是错误的http代码我们就会在控制台看到对应的报错信息。
二、配置Selenium自动测试环境(Java)
- Chrome浏览器。下载地址：https://www.google.cn/intl/zh-CN/chrome/
- Chrome的驱动（ChromeDriver）。注意驱动版本要和你的Chrome浏览器版本对应起来。下载地址：https://chromedriver.chromium.org/downloads
- Selenium3工具包。maven仓库导入依赖：https://mvnrepository.com/artifact/org.seleniumhq.selenium/selenium-java/3.141.59
编写第一个Selenium的Demo：
public static void main(String[] args) throws InterruptedException { // 创建浏览器驱动 WebDriver webDriver = new ChromeDriver(); // 访问百度 webDriver.get("https://www.baidu.com"); }
三、常用 WebDriver API 学习
1、元素定位
元素的定位应该是自动化测试的核心，要想操作一个对象，首先应该识别这个对象，webdriver 提供 findElement()、findElements()两种方法搭配对象定位方法进行元素定位。webdriver 提供了一系列的对象定位方法：id、name、class name、link text、partial link text、tag name、xpath、css selector，我们实际测试中比较常用的主要有两种：
（1）css定位：css selector
css定位是基于css选择器的，我们可以通过查找页面中的选择器定位页面元素内容。比如常见的有id选择器：#id、类选择器：.class、标签选择器：标签名、后代选择器：父标签 子标签。
（2）xpath定位：xpath
XPath 是一种在XML 文档中定位元素的语言。功能比较强大，但是语法比较复杂，如果想要系统学习，推荐网站 W3school，这里大致介绍一下它的基本使用：
- 使用绝对路径定位元素：
/html/head/title整个表达式的含义是从文档的根元素开始，选择其子元素 html，再选择子元素 head，最后选择 head 元素下的子元素 title - 相对路径+索引：
//form/span[1]/input这个表达式表示从根节点开始，找到所有名为“form”的元素，然后在每个form元素中找到第一个span元素，并在该span元素下找到input元素。这种方法使用了索引，以确切指定所需元素的位置。 - 相对路径+属性值：
//input[@class="s_ipt"]此XPath表达式用于选择所有标签名为input且class属性的值为"s_ipt"的元素。@符号用于引用属性，这样就可以根据属性值来定位元素。 - 相对路径+通配符：
//[@="su"]这个XPath表达式使用通配符*来选择文档中所有包含属性名包含指定字符串“su”的元素。这种方法可以用来定位具有特定属性的元素，而不关心具体是哪种元素。 - 相对路径+文本匹配：
//a[text()="新闻"]该表达式选择所有标签名为a且文本内容为“新闻”的元素。在括号内使用text()函数来指定需要匹配的文本内容。
（3）css定位和xpath定位哪个更好？
如果主要任务是在Web开发中定义样式和布局，那么CSS选择器会更加适合；而如果需要进行复杂的XML文档处理或需要更精细的节点定位，XPath选择器则更为合适。另外CSS选择器是专门为HTML文档设计的，浏览器在解析和渲染HTML页面时会针对CSS选择器进行高效的优化。
PS：在实际的测试中可以打开开发者工具使用选择页面元素，鼠标右键即可快速得到元素的 css/xpath 的定位。
2、操作测试对象
click()点击对象sendKeys()在对象上模拟按键输入clear()清除对象中输入的内容submit()对象提交
注：如果点击的元素放在 form 标签中，此时使用 submit 实现的效果和 click 是一样的；如果点击的元素放在非 form 标签中，此时使用 submit 会报错。
public class Main { public static void main(String[] args) throws InterruptedException { // 创建浏览器驱动 WebDriver webDriver = new ChromeDriver(); // 访问百度 webDriver.get("https://www.baidu.com"); sleep(1000); // 在输入框模拟键盘输入 webDriver.findElement(By.cssSelector("#kw")).sendKeys("csdn不摸鱼的程序员"); sleep(1000); // 点击"百度一下" webDriver.findElement(By.cssSelector("#su")).click(); sleep(1000); // 清除输入框 webDriver.findElement(By.cssSelector("#kw")).clear(); sleep(1000); // 点击第一条搜索结果 webDriver.findElement(By.cssSelector("#\\31 > div > div:nth-child(1) > h3 > a")).click(); } }
结果展示：
3、添加等待
（1）强制等待
在上述代码中我们已经用到了 sleep()，sleep() 是强制等待，它会根据里面的时间参数进行等待。
（2）隐式等待
public class ImplicitlyWaitExample { public static void main(String[] args) { WebDriver driver = new ChromeDriver(); driver.manage().timeouts().implicitlyWait(10, TimeUnit.SECONDS); // 设置隐式等待时间为10秒 driver.get("https://www.example.com"); // 后续操作 // ... driver.quit(); } }
在上述示例中，我们使用 driver.manage().timeouts().implicitlyWait(10, TimeUnit.SECONDS) 来设置隐式等待时间为10秒。这样，在查找元素或执行命令时，WebDriver会等待一定的时间直到元素出现或超时为止。
注意事项：
driver.manage().timeouts().implicitlyWait(10, TimeUnit.SECONDS) 被放置在创建ChromeDriver实例之后，但是在执行任何实际的测试步骤之前。这确保了在整个测试过程中都会应用隐式等待设置，以便在查找元素时进行等待。值得注意的是，隐式等待仅需要设置一次，通常在WebDriver实例创建后立即设置即可。在整个测试执行过程中，这个设置会对后续的元素查找操作生效，直到WebDriver实例被关闭或隐式等待设置被清除为止。
（3）显式等待
public class WebDriverWaitExample { public static void main(String[] args) { WebDriver driver = new ChromeDriver(); driver.get("https://www.example.com"); // 使用显式等待等待元素可点击 WebDriverWait wait = new WebDriverWait(driver, 10); WebElement button = wait.until(ExpectedConditions.elementToBeClickable(By.id("myButton"))); button.click(); // 后续操作 // ... driver.quit(); } }
在上述示例中，我们使用了 WebDriverWait 结合 ExpectedConditions，等待直到特定的条件 发生后再继续执行。在这里，我们等待元素可点击后再进行点击操作
4、信息获取
getText()方法用于获取网页元素显示的文本内容，通常指的是元素内部的可见文本。getAttribute()方法用于获取元素的指定属性的值，比如id、name、class等。
public static void main(String[] args) throws InterruptedException { // 创建浏览器驱动 WebDriver webDriver = new ChromeDriver(); // 访问百度 webDriver.get("https://www.baidu.com"); sleep(1000); // 获取百度词条文本 String text = webDriver.findElement( By.cssSelector("#hotsearch-content-wrapper > li:nth-child(1) > a > span.title-content-title")).getText(); System.out.println("元素内文本："+text); sleep(1000); // 获取输入框name String name = webDriver.findElement(By.cssSelector("#kw")).getAttribute("name"); System.out.println("元素属性 name："+name); }
getCurrentUrl()方法用于获取当前浏览器所在页面的 URL 地址。getTitle()方法用于获取当前页面的标题，即页面标签（
public static void main(String[] args) throws InterruptedException { // 创建浏览器驱动 WebDriver webDriver = new ChromeDriver(); // 访问百度 webDriver.get("https://www.baidu.com"); sleep(1000); // 获取百度url String url = webDriver.getCurrentUrl(); System.out.println("百度 url："+url); sleep(1000); // 获取百度title String title = webDriver.getTitle(); System.out.println("百度 title："+title); }
5、鼠标操作
click()点击： 模拟鼠标左键单击操作，可以用于点击链接、按钮或其他可交互的元素。doubleClick()双击： 模拟鼠标左键双击操作，可以用于特定的双击交互场景。
contextClick()右键点击： 模拟鼠标右键单击操作，可以触发上下文菜单或其他右键交互效果。moveToElement()悬停： 将鼠标移动到指定的元素上并悬停，可以用于触发显示悬停菜单或者提示信息。dragAndDrop()拖放： 模拟鼠标拖动操作，通常用于实现拖放交互效果。
Actions类代表用户交互的动作，它用于构建和执行用户在网页上的鼠标、键盘等操作。
public static void main(String[] args) throws InterruptedException { // 创建浏览器驱动 WebDriver driver = new ChromeDriver(); // 访问百度 driver.get("https://www.baidu.com"); sleep(1000); // 获取到百度一下按钮 WebElement element = driver.findElement(By.cssSelector("#su")); // 初始化 action Actions actions = new Actions(driver); // 点击操作 actions.click(element).perform(); sleep(1000); // 获取底部元素 WebElement element1 = driver.findElement(By.cssSelector("#bottom_layer > div > p:nth-child(8)")); // 双击操作 actions.doubleClick(element1).perform(); sleep(1000); // 获取“图片”文字 WebElement element2 = driver.findElement(By.cssSelector("#s-top-left > a:nth-child(6)")); // 右键点击操作 actions.contextClick(element2).perform(); sleep(1000); // 获取到百度logo WebElement element3 = driver.findElement(By.cssSelector("#lg > map > area")); // 悬停操作 actions.moveToElement(element3).perform(); sleep(1000); // 模拟拖放操作(从底部移动到顶部) WebElement sourceElement = driver.findElement(By.cssSelector("#bottom_layer > div > p:nth-child(1) > a")); WebElement targetElement = driver.findElement(By.cssSelector("#s-top-left > a:nth-child(1)")); actions.dragAndDrop(sourceElement, targetElement).perform(); sleep(1000); actions.click().perform(); sleep(1000); }
PS：在 Selenium 中，perform()方法用于执行之前定义的动作序列。当你使用Actions类构建了一系列的鼠标或键盘操作时，这些操作并不会立即执行，而是将它们放入了一个动作序列中。只有当调用perform()方法时，Selenium才会按照你定义的顺序执行这些操作。这种设计方式的好处在于你可以构建复杂的鼠标和键盘操作序列，然后一次性执行它们。
6、键盘操作
- sendKeys(Keys.TAB) // TAB
- sendKeys(Keys.ENTER) // 回车
- sendKeys(Keys.SPACE) // 空格键
- sendKeys(Keys.ESCAPE) // 回退键（Esc）
- sendKeys(Keys.CONTROL,“a”) // 全选（Ctrl+A）
- sendKeys(Keys.CONTROL,“c”) // 复制（Ctrl+C）
- sendKeys(Keys.CONTROL,“x”) // 剪贴（Ctrl+X）
- sendKeys(Keys.CONTROL,“v”) // 粘贴（Ctrl+V）
public static void main(String[] args) throws InterruptedException { // 创建浏览器驱动 WebDriver driver = new ChromeDriver(); // 访问百度 driver.get("https://www.baidu.com"); sleep(2000); // 获取到百度搜索框 WebElement element = driver.findElement(By.cssSelector("#kw")); // 输入内容-》输入空格-》输入内容-》输入TAP-》输入内容-》回车键 element.sendKeys("不摸鱼"); sleep(1000); element.sendKeys(Keys.SPACE); sleep(1000); element.sendKeys("的"); sleep(1000); element.sendKeys(Keys.TAB); sleep(1000); element.sendKeys("程序员"); sleep(1000); element.sendKeys(Keys.ENTER); // 全选-》剪贴-》粘贴 element.sendKeys(Keys.CONTROL,"a"); sleep(1000); element.sendKeys(Keys.CONTROL,"x"); sleep(1000); element.sendKeys(Keys.CONTROL,"v"); sleep(1000); }
7、浏览器操作
webDriver.navigate().forward()：这条语句是用于让浏览器向前导航，即转到浏览历史中的下一个页面。webDriver.navigate().back()：与forward()相反，该语句用于使浏览器返回到浏览历史中的上一个页面。webDriver.manage().window().maximize()：这是用来最大化浏览器窗口的操作。webDriver.manage().window().setSize(new Dimension(width, height))：该语句用于设置浏览器窗口的大小。你可以指定所需的宽度和高度参数，从而调整浏览器窗口的大小，适应不同的测试场景或需求。
window.scrollTo(0, document.body.scrollHeight)Js脚本，实现滚动到页面底部。（第一个参数是水平滚动位置，第二个参数是垂直滚动位置）window.scrollTo(0, 0)Js脚本，实现滚动到页面顶部。
public static void main(String[] args) throws InterruptedException { // 创建浏览器驱动 WebDriver driver = new ChromeDriver(); // 访问百度 driver.get("https://www.baidu.com"); sleep(2000); // 获取到百度搜索框 WebElement element = driver.findElement(By.cssSelector("#kw")); // 搜索“软件测试” element.sendKeys("软件测试"); sleep(1000); element.sendKeys(Keys.ENTER); sleep(1000); // 返回百度首页 driver.navigate().back(); sleep(1000); // 返回软件测试搜索页 driver.navigate().forward(); sleep(1000); // 自定义浏览器窗口 driver.manage().window().setSize(new Dimension(500,500)); sleep(1000); // 实现浏览器窗口最大化 driver.manage().window().maximize(); sleep(1000); // 实现滚动到页面底部 JavascriptExecutor js = (JavascriptExecutor) driver; js.executeScript("window.scrollTo(0, document.body.scrollHeight)"); sleep(1000); // 实现滚动到页面顶部 js.executeScript("window.scrollTo(0, 0)"); sleep(1000); }
8、弹窗操作
Alert弹窗、确认框（Confirm）、提示框（Prompt）：
switchTo().alert()：用于切换到页面上的警告框，并返回一个Alert对象，你可以使用这个对象来接受、取消或者输入文本到警告框中。alert.accept()：用于接受警告框（点击“确定”按钮）。alert.dismiss()：用于取消警告框（点击“取消”按钮）。alert.sendKeys("your_text")：用于在警告框中输入文本。
下面就以Prompt提示框为例进行演示：
public static void main(String[] args) throws InterruptedException { // 创建浏览器驱动 WebDriver webDriver = new ChromeDriver(); // 访问 webDriver.get("http://localhost:63342/autoTest/src/main/page/alert.html?_ijt=g52rrlh3gfrag8ivs5g3ec40c0"); sleep(1500); // 点击弹窗按钮 webDriver.findElement(By.cssSelector("body > button")).click(); sleep(1000); // 切换到页面上的警告框 Alert alert = webDriver.switchTo().alert(); // 点击取消 alert.dismiss(); sleep(1000); // 再次点击按钮 webDriver.findElement(By.cssSelector("body > button")).click(); sleep(1000); // 输入“不摸鱼” alert = webDriver.switchTo().alert(); alert.sendKeys("不摸鱼"); sleep(1000); // 点击确定 alert.accept(); sleep(1000); }
9、选项操作
单选按钮（Radio Button）操作：
- 通过WebElement对象来处理单选按钮。
click()：单击选择单选按钮。
复选框（Checkbox）操作：
- 通过WebElement对象来处理复选框。
click()：单击以切换复选框的选中状态。
public static void main(String[] args) throws InterruptedException { // 创建浏览器驱动 WebDriver webDriver = new ChromeDriver(); // 访问 webDriver.get("http://localhost:63342/autoTest/src/main/page/choice.html?_ijt=fc7i1795ada371afdv81v0iqk2"); sleep(1500); // 选择并点击2/3两个复选框 WebElement box1 = webDriver.findElement(By.cssSelector("#c2")); box1.click(); sleep(1000); WebElement box2 = webDriver.findElement(By.cssSelector("#c3")); box2.click(); sleep(1000); // 选择第二个单选框 WebElement choice = webDriver.findElement(By.cssSelector("#r2")); choice.click(); sleep(1000); }
10、下拉框操作
通过Select类来处理下拉框：
selectByVisibleText("visible_text")：根据下拉选项的可见文本进行选择。selectByValue("value")：根据下拉选项的值进行选择。selectByIndex(index)：根据下拉选项的索引进行选择(从0开始)。
public static void main(String[] args) throws InterruptedException { // 创建浏览器驱动 WebDriver webDriver = new ChromeDriver(); // 访问 webDriver.get("http://localhost:63342/autoTest/src/main/page/pulldown.html?_ijt=bjk05362bbitst3j1nrntnnrn9"); sleep(1500); // 定位下拉框按钮 WebElement shippingMethod = webDriver.findElement(By.name("ShippingMethod")); sleep(1000); // 定义select对象 Select select = new Select(shippingMethod); // 根据索引选择第3个 select.selectByIndex(2); sleep(1000); // 根据属性孩子选择value=11.61 select.selectByValue("11.61"); sleep(1000); }
11、上传文件
WebElement.sendKeys()：这是用于将文件路径发送到 input 元素的方法。你可以找到file input元素，然后调用sendKeys()方法并传递文件的绝对路径作为参数，以便实现文件上传操作。
public static void main(String[] args) throws InterruptedException, IOException { // 创建浏览器驱动 WebDriver webDriver = new ChromeDriver(); // 访问 webDriver.get("http://localhost:63342/autoTest/src/main/page/upload.html?_ijt=bhatof5910d1h8q6675j3jjoa5"); sleep(1500); // 上传图片 WebElement uploadFile = webDriver.findElement(By.cssSelector("body > input[type=file]")); uploadFile.sendKeys("D:\\博客图片\\MyBlog\\java.png"); sleep(1000); }
12、截图
截图操作需要导入Commons-io依赖：https://mvnrepository.com/artifact/commons-io/commons-io/2.11.0
然后调用 TakesScreenshot 接口中的 getScreenshotAs() 方法：
public static void main(String[] args) throws InterruptedException, IOException { // 创建浏览器驱动 WebDriver webDriver = new ChromeDriver(); // 访问 webDriver.get("https://www.baidu.com"); sleep(1500); // 搜索“不摸鱼的程序员” webDriver.findElement(By.cssSelector("#kw")).sendKeys("不摸鱼的程序员-csdn"); webDriver.findElement(By.cssSelector("#su")).click(); sleep(3000); // 截图 File file = ((TakesScreenshot)webDriver).getScreenshotAs(OutputType.FILE); // 将图片保存到硬盘 FileUtils.copyFile(file, new File("D://20231111.png")); }
13、iframe 框架定位
在 web 页面中如果使用到iframe框架，则不能直接对框架内部的元素进行定位，需要先切换到对应的iframe在进行定位操作：
webDriver.switchTo().frame()：这是Selenium中用于切换到指定iframe的主要方法。你可以通过索引、ID、名称或WebElement对象来指定要切换到的iframe。webDriver.switchTo().parentFrame()：当你需要从iframe返回到其上一级的上下文时，可以使用这个方法。
webDriver.switchTo().defaultContent()：如果你需要从所有嵌套的iframes中返回到最外层的页面上下文，可以使用这个方法。
public static void main(String[] args) throws InterruptedException, IOException { // 创建浏览器驱动 WebDriver webDriver = new ChromeDriver(); // 访问 webDriver.get("http://localhost:63342/autoTest/src/main/page/iframe.html?_ijt=hiqvtbuga50aga3831ql9nu2ph"); sleep(1500); // 切换到 iframe:f1 webDriver.switchTo().frame("f1"); // 点击内部的click webDriver.findElement(By.cssSelector("body > div > div > a")).click(); sleep(1000); }
14、多窗口定位
在讲解多窗口定位前，我们先了解一下 窗口句柄：
窗口句柄是一个在操作系统级别用于标识窗口的唯一标识符。在Selenium中，窗口句柄通常用于标识浏览器窗口或标签页，并且允许我们在多个窗口之间进行切换和操作。当你在浏览器中打开一个新的标签页或窗口时，每个窗口都有自己的唯一句柄。通过获取这些句柄，Selenium可以帮助你跟踪和管理不同的窗口，从而实现在多个窗口之间进行切换、定位元素和执行操作的功能。
Selenium 中提供了如下api用于操作窗口：
- 获取当前窗口句柄：使用driver.getWindowHandle()方法可以获取当前窗口的句柄。
- 获取所有窗口句柄：使用driver.getWindowHandles()方法可以获取所有打开窗口的句柄。
- 切换窗口：使用driver.switchTo().window(windowHandle)方法可以切换到指定的窗口。
public static void main(String[] args) throws InterruptedException, IOException { // 创建浏览器驱动 WebDriver webDriver = new ChromeDriver(); // 访问百度(注：此时窗口句柄在百度首页，webDerive的所有操作只能针对首页) webDriver.get("https://www.baidu.com"); sleep(1500); // 打开百度图片窗口 webDriver.findElement(By.cssSelector("#s-top-left > a:nth-child(6)")).click(); sleep(1000); // 先将窗口句柄切换到百度图片窗口 // 1.获取所有窗口句柄 Set<String> windowHandles = webDriver.getWindowHandles(); // 2.找到最后一个句柄即为百度图片窗口句柄 String imageHHandle = ""; for (String handle : windowHandles) { imageHHandle = handle; } // 3.切换到百度图片窗口 webDriver.switchTo().window(imageHHandle); // 点击百度图片窗口中的头像标签 webDriver.findElement(By.cssSelector("#wrapper_head_box > div > div > div > div > div.hotquery > a:nth-child(3)")).click(); sleep(1000); }
15、浏览器关闭操作
webDriver.close()关闭当前聚焦的浏览器窗口，不会清空会话和缓存。webDriver.quit()关闭所有的浏览器窗口，会清空会话和缓存。public static void main(String[] args) throws InterruptedException, IOException { // 创建浏览器驱动 WebDriver webDriver = new ChromeDriver(); // 访问百度(注：此时窗口句柄在百度首页，webDerive的所有操作只能针对首页) webDriver.get("https://www.baidu.com"); String mainHandle = webDriver.getWindowHandle(); // 获取首页句柄 sleep(1500); // 打开百度图片窗口 webDriver.findElement(By.cssSelector("#s-top-left > a:nth-child(6)")).click(); sleep(1500); // 切换到主页（这个操作只是为了将显示页面切换到首页，句柄还是首页） webDriver.switchTo().window(mainHandle); sleep(1500); // 打开百度贴吧窗口 webDriver.findElement(By.cssSelector("#s-top-left > a:nth-child(4)")).click(); sleep(1500); // 关闭当前聚焦页面(注：由于此时窗口句柄为百度首页，所以此时close()会关闭首页，而不是百度图片页) webDriver.close(); sleep(1500); // 关闭浏览器 webDriver.quit(); }
