Skip to main content
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, F1F12.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).
Example Response:

Error Responses

Notes

  • No auto-submit. press: Enter dispatches 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 press for each key; modifier state is released after each call.

Supported editor chords

The following Ctrl/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.