自动化测试 / 系统课时
操作复选框与单选框
操作复选框与单选框
复选框和单选框测试的关键不是“点过了”,而是把控件推进到确定状态并验证结果。本节用 Playwright 的状态型操作完成勾选、取消和单选切换,避免普通 click() 因初始状态不同而把测试写成偶发失败。
学习目标
- 使用
check()、uncheck()操作复选框,并用断言验证最终状态 - 正确切换同组单选框,理解单选项不能按复选框方式“取消”
- 区分
toBeChecked()与isChecked()的适用场景
用状态操作代替普通点击
对复选框直接调用 click() 会执行一次“切换”:原来未选中就选中,原来已选中则取消。如果测试前置状态可能变化,同一条语句会得到相反结果。check() 表达的是“最终必须选中”,uncheck() 表达的是“最终必须未选中”,更适合自动化测试。
Playwright 在执行这类操作时会等待元素满足可操作条件,并在动作后确认状态确实发生变化。定位时优先使用可访问名称,例如 getByRole('checkbox', { name: '订阅更新' }),这样测试更接近用户看到的表单语义。
勾选、取消与切换单选项
下面的测试通过 page.setContent() 构造最小页面,因此可以直接放入 Playwright Test 项目运行,不依赖外部站点。
import { test, expect } from '@playwright/test';
test('操作复选框与单选框', async ({ page }) => {
await page.setContent(`
<label><input type='checkbox'> 订阅更新</label>
<fieldset>
<legend>配送方式</legend>
<label><input type='radio' name='delivery'> 标准配送</label>
<label><input type='radio' name='delivery'> 加急配送</label>
</fieldset>
`);
const newsletter = page.getByRole('checkbox', { name: '订阅更新' });
await newsletter.check();
await expect(newsletter).toBeChecked();
// 复选框可以显式取消,避免依赖当前初始状态。
await newsletter.uncheck();
await expect(newsletter).not.toBeChecked();
const standard = page.getByRole('radio', { name: '标准配送' });
const express = page.getByRole('radio', { name: '加急配送' });
// 单选框通过勾选同组另一项完成切换。
await express.check();
await expect(express).toBeChecked();
await expect(standard).not.toBeChecked();
console.log({
newsletter: await newsletter.isChecked(),
standard: await standard.isChecked(),
express: await express.isChecked(),
});
});预期输出(忽略测试运行器自身日志):
{ newsletter: false, standard: false, express: true }这里同时演示了两种验证方式:toBeChecked() 是 Playwright Test 的自动重试断言,适合等待页面最终进入正确状态;isChecked() 立即返回布尔值,更适合记录状态或作为程序分支条件。测试验收通常优先使用断言,而不是只读取一次状态。
单选框的切换规则
同一组原生单选框通常共享相同的 name,浏览器保证同组最多只有一个选中项。要把“标准配送”切到“加急配送”,直接对“加急配送”调用 check() 即可,原选项会自动取消。
不要把单选框当作复选框处理并尝试“再次点击取消”。业务上如果允许“一个都不选”,通常应由页面提供“无”选项、清空按钮或其他显式交互,测试也应按真实交互路径操作。
常见失败的定位顺序
如果 check() 超时,先确认定位器是否命中了真正的 input 控件,再检查元素是否被禁用、遮挡或尚未显示。若页面使用自定义组件,外层 div 只是视觉包装,应定位实际可交互控件或按照组件暴露的可访问角色操作,而不是直接用 force 绕过问题。
状态型操作的价值在于让测试描述“我要什么结果”,而不是描述“我想点一下”。只要最终状态写清楚,复选框和单选框测试就会更稳定,也更容易在失败时判断是定位、交互还是业务逻辑出了问题。