uncheck(selector[, options])
警告
请改用基于 locator 的
locator.uncheck([options])
。
此方法用于取消选择输入框(checkbox)。
参数 | 类型 | 默认值 | 描述 |
---|---|---|---|
selector | string | '' | 用于搜索元素的 selector。如果存在多个满足条件的元素,将使用第一个。 |
options | object | null | |
options.force | boolean | false | 将其设置为 true 将绕过可操作性检查(visible 可见、stable 稳定、enabled 可用)。 |
options.noWaitAfter | boolean | false | 如果设置为 true 且执行此操作导致导航发生,将不会等待其完成。 |
options.position | object | null | 相对于元素左上角使用的点。如果未提供,则使用元素的可见点。 |
options.position.x | number | 0 | x 坐标。 |
options.position.y | number | 0 | y 坐标。 |
options.strict | boolean | false | 如果设置为 true ,调用要求 selector 解析为单个元素。如果给定的 selector 解析为多个元素,调用将抛出异常。 |
options.timeout | number | 30000 | 最大超时时间(毫秒)。传入 0 禁用超时。默认值会被 BrowserContext 或 Page 上的 setDefaultTimeout 选项覆盖。 |
options.trial | boolean | false | 将其设置为 true 将执行可操作性检查,但不实际执行操作。 |
返回值
类型 | 描述 |
---|---|
Promise<void> | 当 checkbox 被取消选择时完成的 Promise。 |