键盘与鼠标
🌐 Keyboard & Mouse
Keyboard
| 命令 | 描述 |
|---|---|
press <key> | 按下一个键（例如，Enter、ArrowLeft、a） |
keydown <key> | 按下键 |
keyup <key> | 释放键 |
type <text> | 在聚焦元素中逐个键输入文本 |
常用键
🌐 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
keydown / keyup 可以在多个命令间保持一个修改键，而 press 做不到：
playwright-cli keydown Shift
playwright-cli click e5
playwright-cli click e9 # extends the selection
playwright-cli keyup Shift
要保持修饰键只需单击一次，click --modifiers 更简单 — 参见 交互。
🌐 To hold modifiers for a single click, click --modifiers is simpler — see
Interaction.
键盘导航
🌐 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
| 命令 | 描述 |
|---|---|
mousemove <x> <y> | 将鼠标移动到坐标 |
mousedown [button] | 按下鼠标按钮（左、右、中） |
mouseup [button] | 释放鼠标按钮 |
mousewheel <dx> <dy> | 滚动（dx=水平, dy=垂直） |
坐标是相对于视口的 CSS 像素。snapshot --boxes 会在同一个坐标空间报告每个元素的盒子，这比从截图上读位置更靠谱。
🌐 Coordinates are viewport-relative CSS pixels. snapshot --boxes reports each element's box in the
same coordinate space, which beats reading positions off a screenshot.
# 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
| 场景 | 推荐方法 |
|---|---|
| 点击按钮、链接或表单元素 | click、fill 和其他基于引用的命令 |
| 基于画布的应用（绘图、地图） | 带坐标的鼠标命令 |
| 没有辅助功能的自定义 UI 控件 | 带坐标的鼠标命令 |
| 在像素精确的目标上进行拖动交互 | 带坐标的鼠标命令 |
对于大多数 web 应用，来自可访问性快照的引用比坐标更可靠。仅在可访问性树未显示所需元素时使用鼠标命令。
🌐 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.