自动化测试 / 系统课时

选择下拉选项

选择下拉选项

本课学习 Playwright 操作原生 select 下拉框的方法,通过一个可运行的城市选择示例,掌握按值、标签和索引选择选项的方式,并验证最终选择结果。同时说明自定义下拉组件的处理边界,避免把普通菜单误当成原生下拉框。

学习目标

  • 掌握 selectOption() API 的用法和匹配规则。
  • 理解按 value、label 和 index 选择选项的区别。
  • 能够验证选择结果,并判断何时需要改用点击操作。

下拉选择机制

对于 HTML select 元素,Playwright 提供 selectOption() 方法,不需要模拟鼠标展开菜单即可完成稳定选择。

例如,一个城市下拉框可能包含以下选项:

  • value="bj":页面显示“北京”。
  • value="sh":页面显示“上海”。
  • value="":页面显示“请选择”,通常作为默认占位选项。

selectOption() 支持三种常用匹配方式:

选择方式 示例 匹配依据
按值 selectOption('bj') option 的 value 属性
按标签 selectOption({ label: '北京' }) 选项的标签文本
按索引 selectOption({ index: 1 }) 选项在列表中的位置,从 0 开始

调用时,Playwright 会等待目标选项可供选择,完成选择后触发相应的 input 和 change 事件。对于单选下拉框,通常通过 toHaveValue() 检查最终选中的值。

选择选项示例

下面使用 page.setContent() 创建一个本地测试表单,避免依赖外部网站是否存在 #city 元素。将代码保存为 tests/select-option.spec.ts,在已安装 Playwright Test 和浏览器的项目中运行。

ts
import { test, expect } from '@playwright/test';

test('选择城市', async ({ page }) => {
  await page.setContent(`
    <label for="city">城市</label>
    <select id="city">
      <option value="">请选择</option>
      <option value="bj">北京</option>
      <option value="sh">上海</option>
    </select>
  `);

  const city = page.locator('#city');

  // 按 value 属性选择北京
  await city.selectOption('bj');
  await expect(city).toHaveValue('bj');

  // 按选项标签选择上海
  await city.selectOption({ label: '上海' });
  await expect(city).toHaveValue('sh');

  // 索引从 0 开始,占位选项也计入索引
  await city.selectOption({ index: 0 });
  await expect(city).toHaveValue('');
});

在项目根目录执行:

bash
npx playwright test tests/select-option.spec.ts

预期结果(使用默认单浏览器项目配置时):

text
Running 1 test using 1 worker
1 passed (<TIME>)

<TIME> 表示实际运行耗时,不同环境下数值可能不同。如果配置了多个浏览器项目,测试数量也会相应增加。

测试中的三次断言依次验证:

  1. 按值选择后,select 的当前值为 bj。
  2. 按标签选择“上海”后,当前值变为 sh。
  3. 按索引选择第一个占位选项后,当前值变为空字符串。

只要其中一次选择结果不符合预期,对应的 expect() 断言就会失败,测试不会被错误地报告为通过。

参数选择与验证要点

按值选择通常是首选方案,因为 value 一般用于表单提交,通常比显示文案和选项顺序更稳定。

按标签选择适用于页面文案明确、但选项值不方便直接获取的情况。例如,测试需求要求用户选择“北京”,可以使用 selectOption({ label: '北京' })。不过,页面语言切换或标签文案修改后,测试需要同步调整。

按索引选择适用于选项顺序固定的场景。需要注意,索引从 0 开始,请选择 这样的占位选项也会占据一个位置。列表插入新选项后,原来的索引可能选中其他城市。

toHaveValue('bj') 检查的是 select 的当前值,不是页面显示的“北京”。如果测试还需要验证业务状态,例如选中城市后显示对应的配送费用,应继续断言页面中实际变化的费用元素,不能仅凭下拉框值推断业务逻辑正确。

对于带有 multiple 属性的原生多选下拉框,可以向 selectOption() 传入值数组,例如 ['bj', 'sh'],并使用 toHaveValues() 验证多个选中值。普通单选框不应按照多选框处理。

使用边界与排错

selectOption() 只适用于原生 HTML select 元素。如果页面使用 div、button 和其他元素构建自定义下拉组件,需要按照普通元素点击和选择流程处理,例如先点击下拉触发器,再定位可见选项进行点击。

遇到选择失败时,可以依次检查:

  1. 元素类型:确认定位到的是真正的 select,而不是外层容器。
  2. 选项是否存在:检查目标 value、标签或索引是否与当前 DOM 一致。动态加载选项时,应等待实际选项出现。
  3. 元素是否可操作:检查下拉框是否被禁用,或是否受到页面状态限制。
  4. 断言是否正确:使用 toHaveValue() 验证提交值,不要把页面显示文本误当作 value。

实际项目中,应优先选择稳定的业务值进行定位和断言。只有原生 select 才使用 selectOption();自定义下拉组件应按照其真实交互方式操作,并验证最终产生的页面状态。

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

目录与阅读设置

阅读设置

17

记录一个想法

选择下拉选项

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

登录哪都通