跳至主要內容
版本:23.11.1

Page.type() 方法

為文字中的每個字元發送 keydownkeypress/inputkeyup 事件。

若要按下特殊按鍵,例如 ControlArrowDown,請使用 Keyboard.press()

簽名

class Page {
type(
selector: string,
text: string,
options?: Readonly<KeyboardTypeOptions>,
): Promise<void>;
}

參數

參數

類型

描述

selector

string

要查詢頁面的選取器CSS 選取器可以直接傳遞,而Puppeteer 特定的選取器語法允許透過文字a11y 角色和名稱以及xpath進行查詢,並且將這些查詢組合到 shadow root 中。或者,您可以使用前綴來指定選取器類型。

text

string

要輸入到焦點元素的文字。

options

Readonly<KeyboardTypeOptions>

(可選)具有 delay 屬性,此屬性是按鍵之間的等待時間(以毫秒為單位)。預設為 0

回傳值

Promise<void>

範例

await page.type('#mytextarea', 'Hello');
// Types instantly
await page.type('#mytextarea', 'World', {delay: 100});
// Types slower, like a user