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，如果指定，則是 keydown 和 keyup 之間等待的時間 (以毫秒為單位)。預設為 0。接受 commands，如果指定，則為鍵盤快捷鍵的命令，有效命令名稱請參閱 Chromium 原始碼。

回傳值

Promise<void>

備註

如果 key 是單一字元，且除了 Shift 之外沒有按下其他修飾鍵，則也會產生 keypress/input 事件。可以指定 text 選項來強制產生輸入事件。

修飾鍵會影響 Keyboard.press()。按住 Shift 會輸入大寫文字。