check(选择器[, 选项])
警告
请使用基于 locator 的
locator.check([options])
替代。
此方法用于选择输入框(checkbox)。
参数 | 类型 | 默认 | 描述 |
---|---|---|---|
selector | string | '' | 用于搜索元素的定位器。如果多个元素满足此选择器,则使用第一个元素。 |
options | object | null | |
options.force | boolean | false | 将其设置为 true 将绕过可操作性检查(可见 、稳定 、可用 )。 |
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 ,则此调用要求选择器只匹配单个元素。如果给定选择器匹配多个元素,则抛出异常。 |
options.timeout | number | 30000 | 最大超时时间(毫秒)。传入 0 禁用超时。默认值会被 BrowserContext 或 Page 上的 setDefaultTimeout 选项覆盖。 |
options.trial | boolean | false | 将其设置为 true 将执行可操作性检查但不实际执行操作。 |
返回值
类型 | 描述 |
---|---|
Promise<void> | 一个 Promise,当检查操作完成后 fulfilled。 |