跳至主要内容
版本:22.5.0

Keyboard.down() 方法

派发 keydown 事件。

签名:

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

参数

参数类型说明
keyKeyInput要按下的键的名称,例如 ArrowLeft。有关所有键名称的列表,请参阅 KeyInput
optionsReadonly<KeyDownOptions>(可选)选项对象。接受文本,如果指定,则生成带有此文本的输入事件。接受命令,如果指定,则为键盘快捷键的命令,有关有效命令名称,请参阅 Chromium 源代码

返回

Promise<void>

备注

如果key是单个字符,并且除了Shift之外没有按住任何修饰键,则还会生成一个keypress/input事件。可以指定text选项以强制生成输入事件。如果key是修饰键,ShiftMetaControlAlt,则后续按键将使用该活动修饰键发送。要释放修饰键,请使用Keyboard.up()

按一次键后,后续调用Keyboard.down()repeat设置为true。要释放键,请使用Keyboard.up()

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