自动化测试 / 系统课时
选择下拉选项
选择下拉选项
本课学习 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 和浏览器的项目中运行。
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('');
});在项目根目录执行:
npx playwright test tests/select-option.spec.ts预期结果(使用默认单浏览器项目配置时):
Running 1 test using 1 worker
1 passed (<TIME>)<TIME> 表示实际运行耗时,不同环境下数值可能不同。如果配置了多个浏览器项目,测试数量也会相应增加。
测试中的三次断言依次验证:
- 按值选择后,
select的当前值为bj。 - 按标签选择“上海”后,当前值变为
sh。 - 按索引选择第一个占位选项后,当前值变为空字符串。
只要其中一次选择结果不符合预期,对应的 expect() 断言就会失败,测试不会被错误地报告为通过。
参数选择与验证要点
按值选择通常是首选方案,因为 value 一般用于表单提交,通常比显示文案和选项顺序更稳定。
按标签选择适用于页面文案明确、但选项值不方便直接获取的情况。例如,测试需求要求用户选择“北京”,可以使用 selectOption({ label: '北京' })。不过,页面语言切换或标签文案修改后,测试需要同步调整。
按索引选择适用于选项顺序固定的场景。需要注意,索引从 0 开始,请选择 这样的占位选项也会占据一个位置。列表插入新选项后,原来的索引可能选中其他城市。
toHaveValue('bj') 检查的是 select 的当前值,不是页面显示的“北京”。如果测试还需要验证业务状态,例如选中城市后显示对应的配送费用,应继续断言页面中实际变化的费用元素,不能仅凭下拉框值推断业务逻辑正确。
对于带有 multiple 属性的原生多选下拉框,可以向 selectOption() 传入值数组,例如 ['bj', 'sh'],并使用 toHaveValues() 验证多个选中值。普通单选框不应按照多选框处理。
使用边界与排错
selectOption() 只适用于原生 HTML select 元素。如果页面使用 div、button 和其他元素构建自定义下拉组件,需要按照普通元素点击和选择流程处理,例如先点击下拉触发器,再定位可见选项进行点击。
遇到选择失败时,可以依次检查:
- 元素类型:确认定位到的是真正的
select,而不是外层容器。 - 选项是否存在:检查目标
value、标签或索引是否与当前 DOM 一致。动态加载选项时,应等待实际选项出现。 - 元素是否可操作:检查下拉框是否被禁用,或是否受到页面状态限制。
- 断言是否正确:使用
toHaveValue()验证提交值,不要把页面显示文本误当作value。
实际项目中,应优先选择稳定的业务值进行定位和断言。只有原生 select 才使用 selectOption();自定义下拉组件应按照其真实交互方式操作,并验证最终产生的页面状态。