fill(选择器, 值[, 选项])
警告
请改用基于 locator 的
locator.fill(值[, 选项])
。
使用提供的值填充一个 input
、textarea
或 contenteditable
元素。
参数 | 类型 | 默认值 | 描述 |
---|---|---|---|
selector | string | '' | 用于搜索元素的 CSS 选择器。如果匹配到多个元素,将使用第一个。 |
value | string | '' | 用于填充 input 、textarea 或 contenteditable 元素的值。 |
options | object | null | |
options.force | boolean | false | 设置为 true 将绕过可操作性检查(visible 、stable 、enabled )。 |
options.noWaitAfter | boolean | false | 如果设置为 true 并且执行此操作导致导航发生,将不会等待导航完成。 |
options.strict | boolean | false | 当 true 时,调用要求选择器解析为单个元素。如果给定选择器解析为多个元素,则抛出异常。 |
options.timeout | number | 30000 | 最大超时时间(毫秒)。设置为 0 可禁用超时。BrowserContext 或 Page 上的 setDefaultTimeout 选项会覆盖此默认值。 |
返回值
类型 | 描述 |
---|---|
Promise<void> | 在元素填充值后完成的 Promise。 |