Puppeteer 中文文档v25.8.0

Page.type() 方法

为文本中的每个字符发送 keydownkeypress/inputkeyup 事件。

要按下特殊键(如 ControlArrowDown),请使用 Keyboard.press()

签名

class Page {
  type(
    selector: string,
    text: string,
    options?: Readonly<KeyboardTypeOptions>,
  ): Promise<void>;
}

参数

参数

类型

说明

selector

string

用于在页面中查询的选择器CSS 选择器可以直接传入,Puppeteer 特有的选择器语法支持按文本无障碍角色和名称xpath查询,也支持跨 shadow root 组合这些查询。或者,你也可以使用前缀来指定选择器类型。

text

string

要输入到聚焦元素中的文本。

options

Readonly<KeyboardTypeOptions>

(可选) 具有属性 delay,即按键之间等待的时间(以毫秒为单位)。默认为 0

返回值:

Promise<void>

示例

await page.type('#mytextarea', 'Hello');
// Types instantly
await page.type('#mytextarea', 'World', {delay: 100});
// Types slower, like a user