Puppeteer 中文文档v25.8.0

Keyboard.press() 方法

Keyboard.down()Keyboard.up() 的快捷方式。

签名

class Keyboard {
  abstract press(
    key: KeyInput,
    options?: Readonly<KeyPressOptions>,
  ): Promise<void>;
}

参数

参数

类型

说明

key

KeyInput

要按下的键的名称,例如 ArrowLeft。有关所有键名称的列表,请参阅 KeyInput

options

Readonly<KeyPressOptions>

(可选) 选项对象。接受 text,如果指定,则生成包含该文本的输入事件。接受 delay,如果指定,则为 keydownkeyup 之间等待的时间(以毫秒为单位)。默认为 0。接受 commands,如果指定,则为键盘快捷键的命令,有关有效命令名称,请参阅 Chromium 源代码

返回值:

Promise<void>

备注

如果 key 是单个字符,并且除 Shift 之外没有按住其他修饰键,则还会生成 keypress/input 事件。可以指定 text 选项以强制生成 input 事件。

修饰键确实会影响 Keyboard.press()。按住 Shift 会以大写形式输入文本。