Keyboard.down() 方法

發送一個 keydown 事件。

簽名

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

參數

參數	類型	描述
key	KeyInput	要按下的按鍵名稱，例如 ArrowLeft。請參閱 KeyInput 以取得所有按鍵名稱的清單。
options	Readonly<KeyDownOptions>	（選填）一個選項物件。接受 text，如果指定，將產生帶有此 text 的輸入事件。接受 commands，如果指定，則為鍵盤快捷鍵的命令，請參閱 Chromium 原始碼 以取得有效的命令名稱。

回傳值

Promise<void>

備註

如果 key 是單個字元，並且除了 Shift 之外沒有按住修飾鍵，則也會產生 keypress/input 事件。可以指定 text 選項以強制產生輸入事件。如果 key 是修飾鍵，Shift、Meta、Control 或 Alt，則後續的按鍵將在該修飾鍵啟用時發送。要釋放修飾鍵，請使用 Keyboard.up()。

按鍵按下一次後，後續呼叫 Keyboard.down() 會將 repeat 設定為 true。要釋放按鍵，請使用 Keyboard.up()。

修飾鍵確實會影響 Keyboard.down()。按住 Shift 將會輸入大寫的文字。