「自动化测试」Selenium 的使用

使用 Selenium 需要先导入相关依赖

<dependency> 
    <groupId>org.seleniumhq.selenium</groupId> 
    <artifactId>selenium-java</artifactId> 
    <version>4.0.0</version> 
</dependency>

<dependency>
    <groupId>io.github.bonigarcia</groupId>
    <artifactId>webdrivermanager</artifactId>
    <version>5.8.0</version>
    <scope>test</scope>
</dependency>

---

定位元素

CSS 选择器（cssSelector）可用于选中页面中指定的标签元素

复制后得到：

#kw

除了 CSS 选择器，常用的还有 xpath，它是 XML 路径语言，不仅可以在 XML 文件中查找信息，也可以在 HTML 中选取节点
xpath 使用路径表达式来选择 xml 文档中的节点
在 xpath 语法中：

//：获取 HTML 页面中所有节点
//[ 指定节点 ]：获取 HTML 页面中指定节点。比如 //ul 表示获取 HTML 页面所有 ul 节点
[@…] ：匹配节点属性。比如 //[@id=‘kw’] 表示匹配 HTML 页面中 id 属性为 kw 的节点

查找元素时，有时候会出现 NoSuchElementException，说明没找到元素，下面给出排查步骤：

1. 在报错代码前添加 Thread.sleep()，设置的时间长一点
2. 执行自动化，在自动化打开的页面中打开前端开发者工具，手动检查元素是否真的不存在
   如果自动化打开的页面确实不存在该元素，有两种可能：
   ① 手动打开的页面和自动化打开的页面不一样（很可能是登陆和未登录状态下页面不一样）
   ② 元素为动态元素
   如果元素是动态元素，那我们可以先定位动态元素的上一级标签，再增加要定位的元素标签，例如driver.findElement(By.cssSelector(“body > div > section article”));。
   如果自动化打开的页面有该元素，那就是因为代码执行的速度比页面渲染的速度快，页面还没渲染出来，程序就已经找到了，导致元素没有找到。这种情况的解决办法就是添加等待

---

操作测试对象

获取到页面元素之后，接下来就要对元素进行操作了。常见的操作有点击、提交、输入、清除、获取文本等

点击

//找到百度⼀下按钮并点击 
driver.findElement(By.cssSelector("#su")).click();

模拟按键输入

driver.findElement(By.cssSelector("#kw")).sendKeys("输入文字");

清除文本内容

比如在搜索框输入内容之后，想搜索其他关键词，那就需要用到 clear()

driver.findElement(By.cssSelector("#kw")).sendKeys("哔哩哔哩"); 
driver.findElement(By.cssSelector("#kw")).clear(); 
driver.findElement(By.cssSelector("#kw")).sendKeys("百度贴吧");

获取文本信息&属性值

如何判断获取到的元素对应的文本是否符合预期呢？此时我们需要获取元素对应的文本并打印⼀下

String bdtext = driver.findElement(By.xpath("//*[@id="title-content"]/span[1]")).getText();
System.out.println("获取到的内容是："+bdtext); 

获取属性值使用方法 getAttribute("属性名称")

其他

获取当前页面标题：getTitle()
获取当前页面 URL：getCurrentUrl()

---

窗口

当我们进行手工测试时，我们可以通过肉眼来判断当前在哪个窗口，但对于程序来说它是不知道当
前最新的窗口是哪一个。那程序怎么识别每一个窗口呢？
每个浏览器窗口都有一个唯一的属性——句柄（handle），我们可以通过句柄来切换窗口

切换窗口

1. 获取当前页面句柄

driver.getWindowHandle(); 

2. 获取所有页面句柄：

driver.getWindowHandles();

3. 将当前句柄切换为最新页面的

String curWindow = driver.getWindowHandle(); 
Set<String> allWindow = driver.getWindowHandles();
for (String w : allWindow) {
    if (w != curWindow) driver.switchTo().window(w);
}

设置窗口大小

这个了解即可，平时很少用到的

//窗口最大化
driver.manage().window().maximize(); 
//窗口最小化 
driver.manage().window().minimize(); 
//全屏窗口 
driver.manage().window().fullscreen(); 
//手动设置窗口大小 
driver.manage().window().setSize(new Dimension(1024, 768))

---

截屏

自动化脚本一般是部署在机器上自动运行的，如果出现了报错，我们是不知道的，可以通过抓拍来记录当时错误的场景
屏幕截图方法需要额外导入包：

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

public void getScreenShot(String str) throws IOException {
    // 创建日期格式化对象
    SimpleDateFormat sim1 = new SimpleDateFormat("yyyy-MM-dd");
    SimpleDateFormat sim2 = new SimpleDateFormat("HHmmssSS");

    // 通过时间来给截图文件命名，这样可以避免文件名覆盖的问题
    // 获取当前时间并分别进行格式化。dirTime 格式化为 "yyyy-MM-dd"
    String dirTime = sim1.format(System.currentTimeMillis());
    String fileTime = sim2.format(System.currentTimeMillis());

    // 构建截图文件的文件名
    String filename = "./src/test/image/" + dirTime + "/" + str + "-" + fileTime + ".png";
    System.out.println("filename:" + filename);


    File srcFile = ((TakesScreenshot)driver).getScreenshotAs(OutputType.FILE);
    // 把 srcFile 放到指定位置
    FileUtils.copyFile(srcFile,new File(filename));
}

---

等待

强制等待

Thread.sleep(毫秒);

优点：使用简单，调试的时候比较有效
缺点：影响运行效率，浪费大量的时间。所以一般用于调试

隐式等待

隐式等待是⼀种智能等待，用于解决元素未完全加载时 WebDriver 查找和操作元素的问题。它可以规定在查找元素时，在指定时间内不断尝试查找元素。如果找到则代码继续执行，超时没找到元素则抛出 NoSuchElementException

implicitlyWait(Duration 类中提供的毫秒、秒、分钟等方法);

//隐式等待 1000 毫秒 
driver.manage().timeouts().implicitlyWait(Duration.ofMillis(1000)); 
//隐式等待 5 秒 
driver.manage().timeouts().implicitlyWait(Duration.ofSeconds(5));

隐式等待的作用域是整个脚本所有元素，也就是说每次查找元素都需要等待，这样就很浪费时间
注意：隐式等待对非 HTML 页面的元素是不生效的。比如弹窗是无法等待的

---

显式等待

显式等待也是一种智能等待，在指定超时时间的范围内只要满足条件就会继续执行后续的代码
可以看到这里面提供了很多种条件，不用刻意去记，多用用就熟悉了

---

浏览器导航

打开网站：

driver.navigate().to("https://selenium.dev");
//简洁的方法
driver.get("https://selenium.dev");

浏览器的前进、后退、刷新：

driver.navigate().back(); 
driver.navigate().forward(); 
driver.navigate().refresh(); 

关于页面的刷新，这里需要补充一下，就是如果在一个页面有输入内容（比如登录页输入账号密码），希望清除掉输入框中内容的话，可以选中输入框然后 clear，也可以直接 refresh 页面

---

弹窗

弹窗不属于页面的元素，需要使用 selenium 提供的 Alert 接口来定位

1. 警告 & 确认弹窗
   

Alert alert = driver.switchTo.alert(); 
//点击确定
alert.accept() 
//点击取消
alert.dismiss()

2. 提示弹窗
   这种弹窗一般需要输入内容

Alert alert = driver.switchTo.alert();
alert.sendKeys("hello");
alert.accept();
alert.dismiss();