【自动化测试】Selenium详解-WebUI自动化测试

🔥个人主页：中草药

🔥专栏：【Java】登神长阶史诗般的Java成神之路

Selenium 是用于 Web 自动化测试的常用工具，其核心功能围绕浏览器控制、元素操作和页面交互展开。以下是 Selenium 中最常用的函数（方法），按功能分类说明：

Selenium常用函数

浏览器初始化与控制

用于启动浏览器、控制窗口行为等，核心是通过 webdriver 模块初始化浏览器驱动。

函数 / 方法	功能说明	示例
`webdriver.Chrome()`	启动 Chrome 浏览器（需对应 ChromeDriver）	`driver = webdriver.Chrome()`
`webdriver.Firefox()`	启动 Firefox 浏览器（需对应 GeckoDriver）	`driver = webdriver.Firefox()`
`get(url)`	打开指定 URL	`driver.get("https://www.baidu.com")`
back()/forward()/refresh()	前进/后退/刷新页面	`driver.navigate.forward()`
`getTitle()`	获取当前页面标题	`driver.getTitle()`
`getCurrentUrl()`	获取当前页面Url	`driver.getCurrentUrl()`

测试demo

java 复制代码

//浏览器初始化与控制
    public void test02() throws InterruptedException {
        WebDriverManager.chromedriver().setup();
        ChromeOptions options = new ChromeOptions();
        options.addArguments("--remote-allow-origins=*");
        WebDriver driver = new ChromeDriver(options);

        driver.get("https://www.baidu.com/");
        Thread.sleep(1000);
        driver.navigate().to("https://www.csdn.net/");
        Thread.sleep(1000);
        driver.navigate().back();
        Thread.sleep(1000);
        driver.navigate().forward();
        Thread.sleep(1000);
        driver.navigate().refresh();
        Thread.sleep(1000);
        System.out.println(driver.getTitle());
        System.out.println(driver.getCurrentUrl());
        driver.quit();
    }

元素定位

定位方式	说明	示例代码
By.ID	通过元素 `id` 属性定位	`java// 单个元素WebElement username = driver.findElement(By.id("username"));// 多个元素List<WebElement> tags = driver.findElements(By.id("tag"));`
By.NAME	通过元素 `name` 属性定位	`javaWebElement password = driver.findElement(By.name("password"));`
By.CLASS_NAME	通过元素 `class` 属性定位（单个 class）	`javaWebElement submitBtn = driver.findElement(By.className("btn-submit"));`
By.TAG_NAME	通过 HTML 标签名定位	`javaWebElement input = driver.findElement(By.tagName("input"));`
By.LINK_TEXT	通过超链接完整文本定位	`javaWebElement loginLink = driver.findElement(By.linkText("登录"));`
By.PARTIAL_LINK_TEXT	通过超链接部分文本定位	`javaWebElement partialLink = driver.findElement(By.partialLinkText("登"));`
By.CSS_SELECTOR	通过 CSS 选择器定位（推荐）	`java// id选择器WebElement username = driver.findElement(By.cssSelector("#username"));// 层级选择器WebElement navItem = driver.findElement(By.cssSelector(".nav > li"));`
By.XPATH	通过 XPath 路径定位（灵活）	`java// 属性匹配WebElement usernameInput = driver.findElement(By.xpath("//input[@name='username']"));// 文本包含WebElement welcomeDiv = driver.findElement(By.xpath("//div[contains(text(), '欢迎')]"));`

常见的是xpath

更便捷的生成selector/xpath的方式:右键选择复制"Copyselector/xpath"

java 复制代码

public void test03(){
        WebDriverManager.chromedriver().setup();
        ChromeOptions options = new ChromeOptions();
        options.addArguments("--remote-allow-origins=*");
        WebDriver driver = new ChromeDriver(options);

        driver.get("https://www.baidu.com/");
        System.out.println(driver.findElement(By.xpath("//ul[@class='s-hotsearch-content']")).getText());
        System.out.println("--------------------");
        List<WebElement> elements = driver.findElements(By.xpath("//li[@class='hotsearch-item odd']"));
        for (WebElement element : elements) {
            System.out.println(element.getText());
        }
    }

元素操作

方法	说明	示例
`click()`	点击元素（按钮、链接等）	`elem.click();`
`sendKeys(CharSequence...)`	向输入框发送文本（支持键盘按键，如`Keys.ENTER`）	`// 需导入键盘按键类：import org.openqa.selenium.Keys;elem.sendKeys("admin"); // 输入文本elem.sendKeys(Keys.ENTER); // 按回车键`
`clear()`	清空输入框内容	`elem.clear();`
`getText()`	获取元素文本内容（可见文本）	`System.out.println(elem.getText()); // 输出类似"登录按钮"的文本`
`getAttribute(String name)`	获取元素指定属性值	`elem.getAttribute("value"); // 获取输入框当前值elem.getAttribute("href"); // 获取链接的href属性`
`isDisplayed()`	判断元素是否可见	`if (elem.isDisplayed()) { // 元素可见时执行的操作}`
`isEnabled()`	判断元素是否可用（如按钮是否可点击）	`if (elem.isEnabled()) { // 元素可用时执行的操作}`
`isSelected()`	判断复选框 / 单选框是否选中	`if (elem.isSelected()) { // 元素被选中时执行的操作}`

测试demo

java 复制代码

public void test03() throws InterruptedException {
        WebDriverManager.chromedriver().setup();
        ChromeOptions options = new ChromeOptions();
        options.addArguments("--remote-allow-origins=*");
        WebDriver driver = new ChromeDriver(options);

        driver.get("https://www.baidu.com/");
        WebElement element = driver.findElement(By.xpath("//*[@id=\"chat-textarea\"]"));
        WebElement search=driver.findElement(By.xpath("//*[@id=\"chat-submit-button\"]"));
        Thread.sleep(1000);
        element.sendKeys("python");
        Thread.sleep(1000);
        element.clear();
        Thread.sleep(1000);
        element.sendKeys("java");
        Thread.sleep(1000);
        search.click();
        Thread.sleep(3000);
        driver.quit();

    }

窗口与标签页操作

方法	说明	示例
getWindowHandle()	获取当前窗口句柄	`System.out.println(driver.getWindowHandle());`
`getWindowHandles()`	获取所有窗口句柄（列表）	`Set<String> windowHandles = driver.getWindowHandles();`
switchTo().window(handle)	切换到指定窗口	`for(String windowHandle : windowHandles) { if(!windowHandle.equals(driver.getWindowHandle())) { driver.switchTo().window(windowHandle); } }`
`maximize()`	最大化窗口	`driver.manage().window().maximize();`
`minimize()`	最小化窗口	`driver.manage().window().minimize();`
`setSize(new Dimension(width, height))`	设置窗口大小	`driver.manage().window().setSize(new Dimension(1280, 720));`

测试demo

java 复制代码

public void test03() throws InterruptedException {
        WebDriverManager.chromedriver().setup();
        ChromeOptions options = new ChromeOptions();
        options.addArguments("--remote-allow-origins=*");
        WebDriver driver = new ChromeDriver(options);

        driver.get("https://www.baidu.com/");
        Thread.sleep(1000);
        driver.manage().window().maximize();
        Thread.sleep(1000);
        driver.manage().window().minimize();
        Thread.sleep(1000);
        driver.manage().window().fullscreen();
        Thread.sleep(1000);
        driver.manage().window().setSize(new Dimension(1280, 720));
        Thread.sleep(1000);
        WebElement element = driver.findElement(By.xpath("//*[@id=\"hotsearch-content-wrapper\"]/li[1]/a/span[2]"));
        element.click();
        Thread.sleep(1000);
        System.out.println(driver.getWindowHandle());
        Set<String> windowHandles = driver.getWindowHandles();
        for(String windowHandle : windowHandles) {
            if(!windowHandle.equals(driver.getWindowHandle())) {
                driver.switchTo().window(windowHandle);
            }
        }
        Thread.sleep(1000);
        driver.quit();

    }

屏幕截图

我们的自动化脚本一般部署在机器上自动的去运行，如果出现了报错，我们是不知道的，可以通过抓拍来记录当时的错误场景

java 复制代码

File screenshotAs = ((TakesScreenshot) driver).getScreenshotAs(OutputType.FILE);
FileUtils.copyFile(screenshotAs,new File(fileName));

屏幕截图方法需要额外导入包:

XML 复制代码

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

java 复制代码

public void test03() throws InterruptedException, IOException {
        WebDriverManager.chromedriver().setup();
        ChromeOptions options = new ChromeOptions();
        options.addArguments("--remote-allow-origins=*");
        WebDriver driver = new ChromeDriver(options);

        driver.get("https://www.baidu.com/");
        getScreenShot(driver);
        WebElement element = driver.findElement(By.xpath("//*[@id=\"hotsearch-content-wrapper\"]/li[1]/a/span[2]"));
        element.click();
        System.out.println(driver.getWindowHandle());
        Set<String> windowHandles = driver.getWindowHandles();
        getScreenShot(driver);
        Thread.sleep(2000);
        for(String windowHandle : windowHandles) {
            if(!windowHandle.equals(driver.getWindowHandle())) {
                driver.switchTo().window(windowHandle);
            }
        }
        getScreenShot(driver);
        driver.quit();
    }

    public void getScreenShot(WebDriver driver) throws IOException {
        SimpleDateFormat sim1 = new SimpleDateFormat("yyyy-MM-dd");
        SimpleDateFormat sim2 = new SimpleDateFormat("HHmmssSS");
        String dirTime = sim1.format(System.currentTimeMillis());
        String fileTime = sim2.format(System.currentTimeMillis());

        String fileName = "./src/test/image/"+dirTime+"/test_"+fileTime+".png";
        File screenshotAs = ((TakesScreenshot) driver).getScreenshotAs(OutputType.FILE);
        FileUtils.copyFile(screenshotAs,new File(fileName));
    }

等待机制

这里了解一个常见报错 NosuchElementException 出现这个报错的原因主要有以下几种

1、元素选择错误

2、匹配方式不对，xpath->selector

3、自动化打开的界面与手动打开界面不一致（如登录状态不同）

4、动态生成的元素

5、代码执行的速度比页面渲染速度快

这里为了防止因为第五种情况造成的误判，selenium提供了三种等待方式

强制等待

java 复制代码

Thread.sleep();

优点：使用简单，调试的时候比较有效

缺点：影响运行速率，浪费大量时间

隐式等待

隐式等待是一种智能等待，他可以规定在查找元素时，在指定时间内不断查找元素。如果找到则代码继续执行，直到超时没找到元素才会报错。

java 复制代码

driver.manage().timeouts().implicitlyWait(Duration.ofSeconds(3));

隐式等待作用在所有元素上，会等待所有元素加载成功，只要driver对象没有释放，隐式等待会一直生效

若是想等待某一固定元素，隐式等待也会有额外的时间消耗，且隐式等待只能等待页面元素，无法等待弹窗

显示等待

显示等待也是一种智能等待，在指定超时时间范围内只要满足操作的条件就会继续执行后续代码

java 复制代码

new WebDriverWait(driver, Duration.ofSeconds(3)).until($express);

其中$express-->涉及到了selenium.support.ui.ExpectedConditions包下的ExpectedConditions类

返回值：boolean

ExpectedConditions预定义方法的一些示例

elementToBeclickable(By locator)-用于检查元素的期望是可见的并已启用，以便您可以单击它。

textToBe(Bylocator，string str)-检查元素。(精确匹配)

presence0fElementLocated(Bylocator)-检查页面的DOM上是否存在元素

urlToBe(java.lang.String url)-检査当前页面的 URL是一个特定的 URL。

示例

java 复制代码

WebDriverWait wait = new WebDriverWait(driver, Duration.ofSeconds(3));
wait.until(ExpectedConditions
        .presenceOfElementLocated(By.xpath("//*[@id=\"2\"]")));

官方建议：显示等待与隐式等待不建议一起使用，会致使不可预测的等待时间

弹窗

弹窗是在页面上找不到的元素需要做特殊处理，要使用Selenium的alert接口

当页面出现弹窗，必须要进行处理

java 复制代码

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

一般建议用显示等待来处理弹窗

java 复制代码

WebDriverWait wait = new WebDriverWait(driver, Duration.ofSeconds(3));
wait.until(ExpectedConditions.alertIsPresent());

文件上传

点击文件上传的场景会弹窗系统窗口，进行文件的选择

selenium无法识别非web的控件，上传文件窗口为系统自带，无法识别

但是可以使用sendKeys() 来上传指定路径文件

java 复制代码

WebElement ele = driver.findElement(By.cssSelector("body > div > div > 
input[type=file]"));

ele.sendKeys("D:\\upload.html");

浏览器参数设置

设置无头模式

在 Selenium 中，无头模式（Headless Mode） 是指浏览器在无图形界面（GUI）的情况下运行，仅在后台执行自动化操作。这种模式适合在服务器、CI/CD 环境或不需要可视化界面的场景中使用，能显著减少资源占用（内存、CPU）并提高运行速度。

java 复制代码

WebDriverManager.chromedriver().setup();
ChromeOptions options = new ChromeOptions();

// 对于 Chrome 112+，推荐使用 "--headless=new"（新无头模式，功能更完整）
options.addArguments("--headless=new");

// 旧版无头模式（不推荐，可能逐步被淘汰）
// options.addArguments("--headless");

设置加载策略

在 Selenium 中，页面加载策略（Page Load Strategy） 用于控制 WebDriver 等待页面加载完成的时机。简单来说，它决定了浏览器在什么时候停止等待页面加载，并允许脚本继续执行后续操作。这对于优化自动化脚本的执行速度（尤其是处理加载缓慢的页面）非常重要。

策略	优点	缺点	最佳实践
`normal`	兼容性最好，确保所有资源加载完成	速度慢（尤其页面有大量图片 / 视频）	页面加载速度快、需操作所有资源（如图片上传预览）时使用。
`eager`	速度较快，满足大多数 DOM 操作需求	不等待异步加载的资源（如 AJAX 数据）	主要操作表单、文本等 DOM 元素，无需等待图片 / 样式时优先使用。
`none`	速度最快，可在加载中干预页面	需手动处理所有等待（易出现元素未加载）	需拦截页面加载（如阻止弹窗）、或页面加载极慢时使用，必须配合显式等待。

java 复制代码

options.setPageLoadStrategy(PageLoadStrategy.NORMAL);//最慢
options.setPageLoadStrategy(PageLoadStrategy.EAGER);
options.setPageLoadStrategy(PageLoadStrategy.NONE);//最快

要为重活而高兴，不要为死去的忧伤。 ------林清玄

🍀🍀🍀🍀🍀🍀🍀🍀🍀🍀🍀🍀🍀🍀🍀🍀🍀🍀🍀🍀🍀🍀🍀🍀🍀🍀🍀🍀

以上，就是本期的全部内容啦，若有错误疏忽希望各位大佬及时指出💐

制作不易，希望能对各位提供微小的帮助，可否留下你免费的赞呢🌸