菜单
开源
selectOption(selector, values[, options])
警告
请使用基于 locator 的
locator.selectOption()代替。
选择与 <select> 元素中值匹配的一个或多个选项。
| 参数 | 类型 | 默认值 | 描述 |
|---|---|---|---|
| selector | string | '' | 用于搜索元素的 selector。如果存在多个匹配 selector 的元素，将使用第一个。 |
| values | string 或 string[] 或 object | '' | 如果 select 带有 multiple 属性，将选中所有匹配的选项；否则，仅选中与传入选项之一匹配的第一个选项。Object 可以由带有 value、label 或 index 的键组成。 |
| options | object | null | |
| options.force | boolean | false | 将其设置为 true 将绕过可操作性检查 (visible, stable, enabled)。 |
| options.noWaitAfter | boolean | false | 如果设置为 true 并且执行此操作导致导航，则不会等待导航完成。 |
| options.strict | boolean | false | 当为 true 时，此调用要求 selector 解析为单个元素。如果给定 selector 解析为多个元素，则此调用将抛出异常。 |
| options.timeout | number | 30000 | 最大超时时间（毫秒）。传入 0 可禁用超时。默认值会被 BrowserContext 或 Page 上的 setDefaultTimeout 选项覆盖。 |
返回值
| 类型 | 描述 |
|---|---|
Promise<string[]> | 一个 Promise，其解析值为选定选项的列表。 |
