如何在Selenium中编写单次开发可复用的文本校验Assert方法

核心思路是把元素定位、文本获取、断言逻辑全部封装为通用静态方法，所有测试用例直接调用即可，无需重复编写冗余逻辑。

实现步骤 #

• 第一步：创建独立的断言工具类，建议命名为AssertUtils，所有测试用例可统一调用该类的方法
• 第二步：封装通用文本校验逻辑，支持传入元素定位器、预期文本、自定义错误提示三类参数
• 第三步：测试用例中直接调用封装好的方法，一行代码即可完成文本校验

完整代码示例 #

import org.openqa.selenium.By;
import org.junit.Assert;
// 如果用TestNG框架，将上面的Assert导入替换为org.testng.Assert即可

public class AssertUtils {
    /**
     * 校验目标元素文本是否和预期完全一致
     * @param locator Selenium元素定位器
     * @param expectedText 预期显示的文本
     * @param errorMsg 断言失败时抛出的提示信息
     */
    public static void assertElementTextEquals(By locator, String expectedText, String errorMsg) {
        String actualText = getTextFromElement(locator);
        Assert.assertEquals(errorMsg, expectedText, actualText);
    }

    // 重载方法，不传入错误提示时使用默认提示
    public static void assertElementTextEquals(By locator, String expectedText) {
        assertElementTextEquals(locator, expectedText, "错误：元素显示文本与预期不符");
    }

    // 通用的元素文本获取方法，可统一维护等待、异常处理逻辑
    private static String getTextFromElement(By locator) {
        // 此处可增加显式等待逻辑，等待元素可见后再获取文本，避免页面加载慢导致偶现失败
        // driver可替换为你项目中线程安全的驱动实例获取逻辑
        return driver.findElement(locator).getText().trim();
    }
}

测试用例调用方式 #

原来需要3行代码实现的校验，现在仅需1行即可完成：

// 自定义错误提示的调用方式
AssertUtils.assertElementTextEquals(By.xpath("//option[contains(text(),'Name: Z to A')]"), "Name: Z to A", "Error, message not displayed");

// 使用默认错误提示的调用方式
AssertUtils.assertElementTextEquals(By.xpath("//option[contains(text(),'Name: Z to A')]"), "Name: Z to A");

可选扩展功能 #

• 新增assertElementTextContains方法，实现文本模糊匹配，无需完全相等，适配包含动态内容的文本校验场景
• 新增忽略大小写、忽略特殊字符的校验参数，适配不同的校验规则
• 在文本获取逻辑中增加异常捕获，断言失败时自动打印页面当前源码、截图，方便排查问题

内容的提问来源于stack exchange，提问作者Smash