键盘与鼠标

🌐 Keyboard & Mouse

Keyboard

命令	描述
press <key>	按下一个键（例如，Enter、ArrowLeft、a）
keydown <key>	按下键
keyup <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

命令	描述
mousemove <x> <y>	将鼠标移动到坐标
mousedown [button]	按下鼠标按钮（左、右、中）
mouseup [button]	释放鼠标按钮
mousewheel <dx> <dy>	滚动（dx=水平, dy=垂直）

# 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.