Puppeteer 中文文档v25.8.0

Keyboard.type() 方法

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

签名

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

参数

参数

类型

说明

text

string

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

options

Readonly<KeyboardTypeOptions>

(可选) 选项对象。接受 delay,如果指定,则为 keydownkeyup 之间等待的时间(以毫秒为单位)。默认为 0。

返回值:

Promise<void>

备注

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

修饰键不影响 keyboard.type。按住 Shift 不会输入大写文本。

示例

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