Keyboard & Mouse
Keyboard
| Command | Description |
|---|---|
press <key> | Press a key (e.g., Enter, ArrowLeft, a) |
keydown <key> | Press key down |
keyup <key> | Release key |
Common keys
Enter, Tab, Escape, Backspace, Delete, Space,
ArrowUp, ArrowDown, ArrowLeft, ArrowRight,
Home, End, PageUp, PageDown
Key combinations
playwright-cli press Control+a # select all
playwright-cli press Control+c # copy
playwright-cli press Control+v # paste
playwright-cli press Shift+Tab # focus previous
playwright-cli press Alt+Enter # alt+enter
Keyboard navigation
playwright-cli press Tab # next field
playwright-cli press Tab # next field
playwright-cli press ArrowDown # navigate dropdown
playwright-cli press ArrowDown
playwright-cli press Enter # select option
Mouse
| Command | Description |
|---|---|
mousemove <x> <y> | Move mouse to coordinates |
mousedown [button] | Press mouse button (left, right, middle) |
mouseup [button] | Release mouse button |
mousewheel <dx> <dy> | Scroll (dx=horizontal, dy=vertical) |
# Click at coordinates
playwright-cli mousemove 100 200
playwright-cli mousedown
playwright-cli mouseup
# Right-click
playwright-cli mousemove 300 400
playwright-cli mousedown right
playwright-cli mouseup right
# Scroll down 500 pixels
playwright-cli mousewheel 0 500
# Scroll right 200 pixels
playwright-cli mousewheel 200 0
When to use mouse commands
| Scenario | Recommended approach |
|---|---|
| Clicking a button, link, or form element | click, fill, and other ref-based commands |
| Canvas-based apps (drawing, maps) | Mouse commands with coordinates |
| Custom UI controls without accessibility | Mouse commands with coordinates |
| Drag interactions on pixel-precise targets | Mouse commands with coordinates |
For most web applications, refs from accessibility snapshots are more reliable than coordinates. Use mouse commands only when the accessibility tree doesn't expose the elements you need.