Keyboard Press
Browser Sessions
Keyboard Press
Press a single key (printable char or special key name) with optional modifier hold.
POST
Keyboard Press
Overview
Dispatches a single keydown+keyup for a named key. Useful for submitting forms (Enter), dismissing dialogs (Escape), navigating selects (ArrowDown), or triggering shortcuts (Control+A).Path Parameters
string
required
Browser session ID (UUID).
Body
string
required
Either a single printable character (e.g.
a, 1, !) or one of the special keys:Enter, Tab, Escape, Backspace, Delete, Space, ArrowUp, ArrowDown, ArrowLeft, ArrowRight, Home, End, PageUp, PageDown, F1–F12.Unknown names return 400.string
Optional CSS selector to click/focus before pressing.
integer
default:"5000"
How long to wait (ms) for the selector to become visible.
string[]
Modifier keys held for the duration of the press. Each value must be one of
Shift, Control, Alt, Meta.Example Request
Response
Success Response (200)
boolean
True when the key was dispatched successfully.
string
The key that was pressed (echoed from the request).
Error Responses
Notes
- No auto-submit.
press: Enterdispatches the key; any resulting form submission or navigation is the page’s doing. Wait for page state separately if you need confirmation. - Chord syntax is
key+holdKeys[], not a single string. Consistent with/mouse/click. - Holding keys across multiple presses requires calling
pressfor each key; modifier state is released after each call.
Supported editor chords
The followingCtrl/Meta chords execute their editor command in addition to firing the keydown/keyup events, so you can select, copy, paste, and undo in text fields just like a user would:
Other
Ctrl/Meta chords still dispatch the keydown event with the modifier set (page listeners see ctrlKey: true) but don’t trigger browser-chrome accelerators like new-tab or close-tab.