跳至主要内容
版本:22.5.0

ElementHandle.press() 方法

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

签名:

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

参数

参数类型描述
keyKeyInput要按下的键的名称,例如 ArrowLeft。有关所有键名的列表,请参见 KeyInput
optionsReadonly<KeyPressOptions>(可选)

返回值

Promise<void>

备注

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

注意 修饰键会影响 elementHandle.press。按住 Shift 会将文本输入为大写。