Puppeteer 中文文档v25.8.0

ElementHandle.press() 方法

聚焦该元素,然后使用 Keyboard.down()Keyboard.up()

签名

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

参数

参数

类型

说明

key

KeyInput

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

options

Readonly<KeyPressOptions>

(可选)

返回值:

Promise<void>

备注

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

注意 修饰键确实会影响 elementHandle.press。按住 Shift 会以大写形式输入文本。