Files
puppeteer/docs/api/puppeteer.elementhandle.press.md
dependabot[bot]GitHubdependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>Nikolay Vitkov
4afe06b61d chore(deps-dev): Bump the dev-dependencies group with 14 updates (#13982)
Signed-off-by: dependabot[bot] <[email protected]>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Nikolay Vitkov <[email protected]>
2025-07-02 08:16:05 +00:00

1.2 KiB

sidebar_label
sidebar_label
ElementHandle.press

ElementHandle.press() method

Focuses the element, and then uses Keyboard.down() and Keyboard.up().

Signature

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

Parameters

Parameter

Type

Description

key

KeyInput

Name of key to press, such as ArrowLeft. See KeyInput for a list of all key names.

options

Readonly<KeyPressOptions>

(Optional)

Returns:

Promise<void>

Remarks

If key is a single character and no modifier keys besides Shift are being held down, a keypress/input event will also be generated. The text option can be specified to force an input event to be generated.

NOTE Modifier keys DO affect elementHandle.press. Holding down Shift will type the text in upper case.