JavaSelenium表格排序验证技巧

本文详细介绍了如何利用 **Java Selenium** 自动化测试框架，实现对网页表格中特定列（如金额）排序功能的验证。文章将指导你模拟用户点击排序按钮，提取表格数据并进行清洗和类型转换，最终与程序内部排序后的数据进行对比，确保网页数据的排序与预期一致。通过本文，你将学习到环境搭建、页面交互、数据处理以及结果验证等全流程操作，并获得可复用的代码示例和实用的最佳实践，助力你高效地完成表格排序的自动化测试，提升测试效率和准确性。了解更多 **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("金额列已成功按升序排序验证通过！");

        // 如果需要验证降序，可以再次点击 '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 5，您也可以选择 TestNG，其提供了更丰富的注解和报告功能，尤其适合大型测试套件。

5. 总结

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

今天带大家了解了的相关知识，希望对你有所帮助；关于文章的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~