介绍

基于 Selenium 的自动化测试提供一个便捷的浏览器驱动初始化和操作封装，使得测试人员能够方便地使用不同浏览器进行网页自动化操作。

// 声明当前类所属的包为 utils，用于组织相关的工具类
package utils;

// 导入 Selenium 框架中的 WebDriver 接口，它是操作浏览器的核心接口
import org.openqa.selenium.WebDriver;
// 导入 Chrome 浏览器对应的驱动类，用于创建 Chrome 浏览器的驱动实例
import org.openqa.selenium.chrome.ChromeDriver;
// 导入 Edge 浏览器对应的驱动类，用于创建 Edge 浏览器的驱动实例
import org.openqa.selenium.edge.EdgeDriver;
// 导入 Firefox 浏览器对应的驱动类，用于创建 Firefox 浏览器的驱动实例
import org.openqa.selenium.firefox.FirefoxDriver;
// 导入 Java 8 引入的 Duration 类，用于设置时间间隔，如页面加载超时时间
import java.time.Duration;

/**
 * Browser 类用于封装浏览器驱动的初始化、导航到指定 URL、获取 WebDriver 实例以及关闭浏览器等操作。
 * 通过该类可以方便地根据不同的浏览器类型创建对应的 WebDriver 实例，并进行相关操作。
 */
public class Browser {

    // 声明一个私有的 WebDriver 类型的成员变量，用于存储具体的浏览器驱动实例
    private WebDriver driver;
    // 声明一个私有的常量，用于存储浏览器驱动程序所在的路径，默认值为 "driver"
    private final String driverPath = "driver";

    /**
     * 构造函数，用于初始化 Browser 类的实例。
     * 根据传入的浏览器类型初始化 WebDriver 实例，并将浏览器导航到指定的 URL。
     * 
     * @param browserType 浏览器类型，支持的值为 "chrome", "firefox", "edge"
     * @param url         要访问的 URL 地址
     */
    public Browser(String browserType, String url) {
        // 调用 initializeDriver 方法，根据传入的浏览器类型初始化 WebDriver 实例
        initializeDriver(browserType);
        // 调用 navigateToUrl 方法，将浏览器导航到指定的 URL
        navigateToUrl(url);
    }

    /**
     * 初始化 WebDriver 实例。
     * 根据传入的浏览器类型，设置相应的系统属性并创建对应的浏览器驱动实例。
     * 同时设置浏览器窗口最大化和页面加载超时时间。
     * 
     * @param browserType 浏览器类型，该方法会将其转换为小写进行匹配
     */
    private void initializeDriver(String browserType) {
        // 使用 switch 语句根据浏览器类型进行不同的处理，将传入的 browserType 转换为小写以忽略大小写
        switch (browserType.toLowerCase()) {
            case "chrome":
                // 设置 Chrome 浏览器驱动的系统属性，指定驱动程序的路径
                System.setProperty("webdriver.chrome.driver", driverPath + "/chromedriver.exe");
                // 创建 Chrome 浏览器的驱动实例
                driver = new ChromeDriver();
                break;
            case "firefox":
                // 设置 Firefox 浏览器驱动的系统属性，指定驱动程序的路径
                System.setProperty("webdriver.gecko.driver", driverPath + "/geckodriver.exe");
                // 创建 Firefox 浏览器的驱动实例
                driver = new FirefoxDriver();
                break;
            case "edge":
                // 设置 Edge 浏览器驱动的系统属性，指定驱动程序的路径
                System.setProperty("webdriver.edge.driver", driverPath + "/msedgedriver.exe");
                // 创建 Edge 浏览器的驱动实例
                driver = new EdgeDriver();
                break;
            default:
                // 如果传入的浏览器类型不支持，抛出 IllegalArgumentException 异常
                throw new IllegalArgumentException("Unsupported browser type: " + browserType);
        }

        // 将浏览器窗口最大化
        driver.manage().window().maximize();
        // 设置页面加载超时时间为 30 秒
        driver.manage().timeouts().pageLoadTimeout(Duration.ofSeconds(30));
    }

    /**
     * 导航到指定 URL。
     * 使用 WebDriver 的 navigate().to() 方法将浏览器导航到指定的 URL 地址。
     * 
     * @param url 要访问的 URL 地址
     */
    private void navigateToUrl(String url) {
        // 调用 WebDriver 的 navigate().to() 方法，将浏览器导航到指定的 URL
        driver.navigate().to(url);
    }

    /**
     * 获取 WebDriver 实例。
     * 该方法用于返回当前 Browser 类实例中存储的 WebDriver 实例。
     * 
     * @return WebDriver 实例
     */
    public WebDriver getDriver() {
        return driver;
    }

    /**
     * 关闭浏览器。
     * 该方法用于关闭当前浏览器窗口，并释放 WebDriver 占用的系统资源。
     * 在关闭浏览器后，将 driver 成员变量置为 null。
     */
    public void close() {
        // 检查 driver 成员变量是否不为 null
        if (driver != null) {
            // 调用 WebDriver 的 quit() 方法关闭浏览器并释放资源
            driver.quit();
            // 将 driver 成员变量置为 null，避免后续误操作
            driver = null;
        }
    }
}

 

对Browser类进行测试

package verifyAndTest;

import org.openqa.selenium.WebDriver;
import org.testng.Assert;
import org.testng.annotations.AfterMethod;
import org.testng.annotations.Test;
import utils.Browser;

public class BrowserTest {

    private Browser browser;

    @Test
    public void testBrowser() {
        // 创建 Browser 对象并进行初始化和导航
        // 浏览器类型，支持的值为 "chrome", "firefox", "edge"
        // url – 要访问的 URL 地址
        browser = new Browser("chrome", "https://www.baidu.com/");

        // 获取 WebDriver 实例
        WebDriver driver = browser.getDriver();

        // 断言浏览器标题是否正确
        Assert.assertEquals(driver.getTitle(), "百度一下，你就知道");
    }

    @AfterMethod
    public void tearDown() {
        if (browser != null) {
            browser.close();
        }
    }
}

总结

Browser 类通过封装浏览器驱动的初始化、页面导航、获取驱动实例和关闭浏览器等操作，为基于 Selenium 的自动化测试提供了一个简洁、易用的工具类，减少了测试代码中重复的浏览器初始化和操作代码，提高了测试代码的可维护性和可扩展性。

【完】

分享，让更多的人少走弯路！

#selenium##自动化测试##软件测试#