自动化测试 / 系统课时

操作复选框与单选框

操作复选框与单选框

复选框和单选框测试的关键不是“点过了”,而是把控件推进到确定状态并验证结果。本节用 Playwright 的状态型操作完成勾选、取消和单选切换,避免普通 click() 因初始状态不同而把测试写成偶发失败。

学习目标

  • 使用 check()、uncheck() 操作复选框,并用断言验证最终状态
  • 正确切换同组单选框,理解单选项不能按复选框方式“取消”
  • 区分 toBeChecked() 与 isChecked() 的适用场景

用状态操作代替普通点击

对复选框直接调用 click() 会执行一次“切换”:原来未选中就选中,原来已选中则取消。如果测试前置状态可能变化,同一条语句会得到相反结果。check() 表达的是“最终必须选中”,uncheck() 表达的是“最终必须未选中”,更适合自动化测试。

Playwright 在执行这类操作时会等待元素满足可操作条件,并在动作后确认状态确实发生变化。定位时优先使用可访问名称,例如 getByRole('checkbox', { name: '订阅更新' }),这样测试更接近用户看到的表单语义。

勾选、取消与切换单选项

下面的测试通过 page.setContent() 构造最小页面,因此可以直接放入 Playwright Test 项目运行,不依赖外部站点。

ts
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(),
  });
});

预期输出(忽略测试运行器自身日志):

text
{ newsletter: false, standard: false, express: true }

这里同时演示了两种验证方式:toBeChecked() 是 Playwright Test 的自动重试断言,适合等待页面最终进入正确状态;isChecked() 立即返回布尔值,更适合记录状态或作为程序分支条件。测试验收通常优先使用断言,而不是只读取一次状态。

单选框的切换规则

同一组原生单选框通常共享相同的 name,浏览器保证同组最多只有一个选中项。要把“标准配送”切到“加急配送”,直接对“加急配送”调用 check() 即可,原选项会自动取消。

不要把单选框当作复选框处理并尝试“再次点击取消”。业务上如果允许“一个都不选”,通常应由页面提供“无”选项、清空按钮或其他显式交互,测试也应按真实交互路径操作。

常见失败的定位顺序

如果 check() 超时,先确认定位器是否命中了真正的 input 控件,再检查元素是否被禁用、遮挡或尚未显示。若页面使用自定义组件,外层 div 只是视觉包装,应定位实际可交互控件或按照组件暴露的可访问角色操作,而不是直接用 force 绕过问题。

状态型操作的价值在于让测试描述“我要什么结果”,而不是描述“我想点一下”。只要最终状态写清楚,复选框和单选框测试就会更稳定,也更容易在失败时判断是定位、交互还是业务逻辑出了问题。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

操作复选框与单选框

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通