Keyboard.down() 方法

派发 keydown 事件。

签名

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

参数

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

返回值：

Promise<void>

备注

如果 key 是单个字符，并且除 Shift 之外没有按住其他修饰键，则还会生成 keypress/input 事件。可以指定 text 选项以强制生成 input 事件。如果 key 是修饰键，如 Shift、Meta、Control 或 Alt，则后续按键将在该修饰键激活的状态下发送。要释放修饰键，请使用 Keyboard.up()。

在按键被按下一次之后，对 Keyboard.down() 的后续调用会将 repeat 设置为 true。要释放该键，请使用 Keyboard.up()。

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