Java+Playwright实战：表单单选与多选按钮自动化测试

1. 项目概述

作为一名在测试自动化领域摸爬滚打多年的老手，我见证了从Selenium到Cypress再到Playwright的技术演进。最近在团队内部技术分享会上，我详细演示了如何使用Java+Playwright处理表单中的单选和多选按钮，现场反响热烈。今天就把这套经过实战检验的操作方案完整分享出来，特别是那些官方文档里不会告诉你的细节陷阱。

Playwright作为微软开源的下一代浏览器自动化工具，其核心优势在于：

• 原生支持多浏览器（Chromium/WebKit/Firefox）且API高度统一
• 自动等待机制大幅减少flakey tests（不可靠测试）
• 强大的选择器引擎支持文本内容、位置等多种定位方式
• 相比Selenium更快的执行速度和更简洁的API设计

而Java作为企业级应用的主流语言，与Playwright的结合为传统Java技术栈团队提供了平滑过渡到现代测试框架的路径。本文将聚焦Web表单测试中最常见但陷阱最多的单选（radio）和多选（checkbox）控件操作场景。

2. 环境准备与基础配置

2.1 项目依赖配置

使用Maven构建项目时，需在pom.xml中添加以下核心依赖：

xml复制<dependencies>
    <!-- Playwright核心库 -->
    <dependency>
        <groupId>com.microsoft.playwright</groupId>
        <artifactId>playwright</artifactId>
        <version>1.42.0</version>
    </dependency>
    
    <!-- 测试框架选用TestNG -->
    <dependency>
        <groupId>org.testng</groupId>
        <artifactId>testng</artifactId>
        <version>7.8.0</version>
        <scope>test</scope>
    </dependency>
</dependencies>

注意：Playwright Java库版本建议保持最新，可通过Maven仓库查询当前稳定版。版本差异可能导致API不兼容。

2.2 浏览器初始化最佳实践

推荐使用try-with-resources确保资源释放：

java复制import com.microsoft.playwright.*;

public class RadioCheckboxTest {
    private static Playwright playwright;
    private static Browser browser;
    private static BrowserContext context;
    private static Page page;
    
    @BeforeClass
    public void setup() {
        playwright = Playwright.create();
        browser = playwright.chromium().launch(
            new BrowserType.LaunchOptions().setHeadless(false)
        );
        context = browser.newContext();
        page = context.newPage();
    }
    
    @AfterClass
    public void tearDown() {
        context.close();
        browser.close();
        playwright.close();
    }
}

关键配置建议：

1. 开发阶段建议setHeadless(false)便于调试
2. 生产环境应启用setHeadless(true)并配合setSlowMo(100)降低执行速度
3. 使用独立的BrowserContext隔离测试用例

3. 单选按钮操作全解析

3.1 定位策略深度对比

假设有以下HTML单选组：

html复制<label>
    <input type="radio" name="gender" value="male"> Male
</label>
<label>
    <input type="radio" name="gender" value="female"> Female
</label>

方案1：文本内容定位（最推荐）

java复制page.locator("text=Male").click();

优势：直接对应可见文本，可读性最佳
局限：多语言场景需调整

方案2：CSS属性选择器

java复制page.locator("input[type='radio'][value='male']").click();

优势：精准定位DOM属性
局限：对前端修改敏感

方案3：XPath定位

java复制page.locator("//input[@name='gender' and @value='male']").click();

优势：复杂DOM结构下的灵活性
局限：性能较差且易脆断

实战建议：优先采用文本定位，表单元素变化时维护成本最低。对于动态生成的内容，可配合page.waitForSelector()确保元素可用。

3.2 状态验证进阶技巧

常规检查方式：

java复制Locator maleRadio = page.locator("input[value='male']");
assertTrue(maleRadio.isCh