本文详细介绍了如何使用 Java Selenium 自动测试框架验证了网页表中特定列(如金额)的排序功能。通过模拟用户点击排序按钮,提取表数据,清理和转换数据和类型,然后与程序内部排序后的数据进行比较,以确保网页显示的数据顺序与预期一致。该教程包括完整的代码示例和最佳实践,以帮助读者有效地实现表排序的自动验证。1. 引言

在网页自动化测试中,验证表数据的排序功能是一个常见的要求。用户通常希望在点击表列头时正确排列数据。本教程将演示如何使用特定的示例(验证金额列的排序) Java Selenium 实现这个验证过程。我们将涵盖从环境构建、页面交互到数据提取、清洁、排序和断言的完整过程。

2. 环境准备和项目设置

请确保以下组件已安装在您的开发环境中:

  • Java Development Kit (JDK)
  • Maven 或 Gradle (项目依赖管理)
  • IntelliJ IDEA 或 Eclipse (IDE)
  • ChromeDriver (与您的 Chrome 浏览器版兼容)

在 Maven 项目的 pom.xml 文件中添加 Selenium 和 JUnit(或 TestNG)依赖:

<dependencies>
    <!-- Selenium Java Client -->
    <dependency>
        <groupId>org.seleniumhq.selenium</groupId>
        <artifactId>selenium-java</artifactId>
        <version>4.1.2</version> <!-- 请使用最新的稳定版本 -->
    </dependency>
    <!-- JUnit 5 -->
    <dependency>
        <groupId>org.junit.jupiter</groupId>
        <artifactId>junit-jupiter-api</artifactId>
        <version>5.8.2</version> <!-- 请使用最新的稳定版本 -->
        <scope>test</scope>
    </dependency>
    <dependency>
        <groupId>org.junit.jupiter</groupId>
        <artifactId>junit-jupiter-engine</artifactId>
        <version>5.8.2</version> <!-- 请使用最新的稳定版本 -->
        <scope>test</scope>
    </dependency>
</dependencies>

3. 详细介绍了自动化测试过程

表格排序验证将通过以下步骤实现:

  1. 初始化 WebDriver 并登录: 设置 ChromeDriver 路径,启动浏览器并导航到登录页面,然后执行登录操作。
  2. 导航到目标页面并触发排序: 登录成功后,导航到包含表格的页面,点击需要排序的列头(例如”Amount列)触发排序。
  3. 提取表格数据: 在获得排序后的表中“”Amount列出的所有可见数据。
  4. 数据清洗与类型转换: 清理提取的字符串数据(删除货币符号、逗号等。)并将其转换为数值类型(例如) Double),为了进行准确的数值排序。
  5. 程序内部排序: 复制并使用清洗和转换后的数据 Java 的 Collections.sort() 该方法对程序内部进行排序。
  6. 验证排序结果: 比较从网页上提取的数据列表和程序内部排序后的数据列表,以确保两者的顺序一致。

3.1 基本设置和登录首先,设置 ChromeDriver 并实现登录功能。

package com.example.selenium;

import org.junit.jupiter.api.AfterAll;
import org.junit.jupiter.api.BeforeAll;
import org.junit.jupiter.api.Test;
import org.openqa.selenium.By;
import org.openqa.selenium.JavascriptExecutor;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.WebElement;
import org.openqa.selenium.chrome.ChromeDriver;
import org.openqa.selenium.chrome.ChromeOptions;
import org.openqa.selenium.support.ui.ExpectedConditions;
import org.openqa.selenium.support.ui.WebDriverWait;

import java.time.Duration;
import java.util.ArrayList;
import java.util.Collections;
import java.util.List;
import java.util.stream.Collectors;

import static org.junit.jupiter.api.Assertions.assertEquals;
import static org.junit.jupiter.api.Assertions.assertTrue;

public class TableSortVerificationTest {

    private static WebDriver driver;
    private static WebDriverWait wait;
    private static final String BASE_URL = "https://sakshingp.github.io/assignment/";

    @BeforeAll
    public static void setup() {
        // 设置 ChromeDriver 路径
        // System.setProperty("webdriver.chrome.driver", "path/to/your/chromedriver.exe");
        // 如果 ChromeDriver 已经在 PATH 中,则无需设置

        ChromeOptions options = new ChromeOptions();
        // options.addArguments("--headless"); // 无头模式运行
        options.addArguments("--start-maximized"); // 最大化窗口

        driver = new ChromeDriver(options);
        wait = new WebDriverWait(driver, Duration.ofSeconds(10)); // 显式等待,最长10秒
        driver.get(BASE_URL + "login.html");

        // 执行登录操作
        wait.until(ExpectedConditions.visibilityOfElementLocated(By.id("username"))).sendKeys("Lakshay");
        driver.findElement(By.id("password")).sendKeys("Wingify");
        driver.findElement(By.id("log-in")).click();

        // 等待登录成功,跳转 home 页面
        wait.until(ExpectedConditions.urlContains("home.html"));
        System.out.println("成功登录,当前URL: " + driver.getCurrentUrl());
    }

    @AfterAll
    public static void teardown() {
        if (driver != null) {
            driver.quit();
        }
    }

    // ... 这里将添加后续的测试方法
}

3.2 验证金额排序功能

现在,我们编写一个测试方法来验证“Amount列的排序。

// 承接上文的 TableSortVerificationTest 类
public class TableSortVerificationTest {
    // ... setup 和 teardown 方法 ...

    @Test
    public void verifyAmountColumnSorting() {
        System.out.println("开始验证金额列的排序...");

        // 1. 点击“定位并点击”“”“定位并点击”Amount列头触发排序
        WebElement amountHeader = wait.until(ExpectedConditions.elementToBeClickable(By.id("amount")));
        amountHeader.click();
        System.out.println("已点击 'Amount' 排序列头。");

        // 2. 提取排序后的金额数据
        // 这里的XPath定位到表格中的所有金额<span>元素
        List<WebElement> amountElements = driver.findElements(By.xpath("//table[@id='transactionsTable']/tbody/tr/td/span[@class='text-danger' or @class='text-success']"));

        // 用于存储从网页中提取和清洁的数值
        List<Double> actualSortedAmounts = new ArrayList<>();

        for (WebElement element : amountElements) {
            String text = element.getText();
            // 3. 数据清洗和类型转换
            // 移除 "USD", "," 和空格,然后转换成 Double
            String cleanedText = text.replaceAll("USD", "")
                                     .replaceAll(",", "")
                                     .trim();
            try {
                // 有些值是可能的 "-" 例如,开头表示负数 "- 244.00 USD"
                // 需要进一步处理,确保 Double.parseDouble 能正确分析
                double amount = Double.parseDouble(cleanedText);
                actualSortedAmounts.add(amount);
            } catch (NumberFormatException e) {
                System.err.println("金额无法分析: " + cleanedText + ",原始文本: " + text);
                // 根据实际情况选择抛出异常或跳过
            }
        }
        System.out.println("从网页上提取和清洗的金额列表 (实际顺序): " + actualSortedAmounts);

        // 4. 程序内部排序
        // 创建内部排序的副本,不改变原始提取顺序
        List<Double> expectedSortedAmounts = new ArrayList<>(actualSortedAmounts);
        Collections.sort(expectedSortedAmounts); // 默认升序排序
        System.out.println("程序内部排序后的金额列表 (预期升序): " + expectedSortedAmounts);

        // 5. 验证排序结果
        // 比较实际的排序结果和预期的排序结果
        assertEquals(expectedSortedAmounts, actualSortedAmounts, "金额列未能按升序正确排序!");
        System.out.println("按升级顺序成功验证金额列!");
        System.out.println("按升级顺序成功验证金额列!");

        // 如果需要验证降序,可以再次单击 'Amount' 列头,然后对 expectedSortedAmounts 进行 Collections.reverse()
        // amountHeader.click(); // 再次单击切换到降序
        // Collections.reverse(expectedSortedAmounts);
        // actualSortedAmounts.clear(); // 降序数据重新提取
        // ... 重新提取和验证降序逻辑 ...
    }
}

代码解释:

  • @BeforeAll 和 @AfterAll: JUnit 5 注释分别用于在所有测试方法运行前(如浏览器初始化和登录)和所有测试方法运行后(如关闭浏览器)的清理。
  • WebDriverWait: 用于实现显式等待,确保元素可见或点击,避免页面加载速度差造成的 NoSuchElementException。
  • By.id("amount"): 定位到“Amount“列头的元素通常是表格列头的唯一元素 ID。
  • driver.findElements(By.xpath("//table[@id='transactionsTable']/tbody/tr/td/span[@class='text-danger' or @class='text-success']")): 这个 XPath 用于定位表格的表达式 transactionsTable 中 tbody 下所有行 tr 的 td 单元格内的 span 元素。这里要特别注意的是,金额数字是包裹在一起的 text-danger 或 text-success 类的 span 在标签中,这有助于准确提取金额文本。
  • 数据清洗 (replaceAll 和 trim): 移除不必要的字符,如 "USD"、逗号和多余的空间,以便 Double.parseDouble() 能正确分析。
  • Double.parseDouble(): 将清洗后的字符串转换为 Double 类型,这是数值排序的关键。
  • Collections.sort(expectedSortedAmounts): 对 expectedSortedAmounts 升序排序列表。
  • assertEquals(expectedSortedAmounts, actualSortedAmounts, ...): JUnit 断言方法用于比较两个列表是否完全相等。如果相等,则测试通过;否则,测试失败,显示错误信息。

4. 注意事项和最佳实践

  • XPath/CSS Selector 的健壮性: 确保您使用的定位器足够稳定,不会因为页面的小变化而失效。尽量使用 ID 或者具有独特的属性。如有必要,可与开发团队沟通,为关键元素添加友好的测试 ID。
  • 等待策略: 始终使用显式等待 (WebDriverWait) 处理页面元素的加载和可见性,而不是硬编码 Thread.sleep()。这可以提高测试的稳定性和可靠性。
  • 数据类型转换: 对于数值数据,必须将其转换为相应的数值类型(例如 Double, Integer, BigDecimal)然后进行排序比较,避免字符串字典排序错误。
  • 处理各种排序顺序: 如果表格支持升序和降序切换,则需要编写额外的逻辑来模拟多次点击,并验证两个排序顺序。例如,第一次点击验证升序,第二次点击验证降序(此时需要 Collections.reverse(expectedSortedAmounts))。
  • 异常处理: 在数据清洗和类型转换过程中,应考虑 NumberFormatException 特别是当数据格式不确定时,等异常情况。
  • 可读性和维护性: 保持代码清晰和模块化。使用有意义的变量名和方法名,并添加必要的注释。
  • 测试框架的选择: 本例使用 JUnit 你也可以选择 TestNG,它提供了更丰富的注释和报告功能,特别适用于大型测试套件。

5. 总结通过这个教程,你应该已经掌握了使用它 Java Selenium 验证网页表数据排序功能的核心技术。关键是准确提取数据,彻底清洁和正确转换类型,然后使用它 Java 集合框架内部排序程序,最终与从网页获取的实际数据进行比较。遵循这些步骤和最佳实践可以有效地提高您的自动化测试覆盖率和质量。

Logo

汇聚全球AI编程工具,助力开发者即刻编程。

更多推荐