跳至主要內容
版本:23.11.1

ElementHandle.press() 方法

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

簽名

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

參數

參數

類型

描述

key

KeyInput

要按下的按鍵名稱,例如 ArrowLeft。請參閱 KeyInput 以取得所有按鍵名稱的列表。

options

Readonly<KeyPressOptions>

(可選)

回傳

Promise<void>

備註

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

注意 修飾鍵會影響 elementHandle.press。按住 Shift 將以大寫形式輸入文字。