browser_drag
Drag an element to a target using ref IDs from a browser snapshot, with human-like mouse movement and fallback for HTML5 drag-and-drop compatibility.
Instructions
Drag one element to another by their [@eN] ref IDs from browser_snapshot.
Humanized by default: picks non-center points, follows a curved uneven mouse path, and uses randomized timing. If that fails, fallback=True retries with Playwright's native drag_to for HTML5 drag-and-drop compatibility. Returns an updated snapshot.
Args: page_id: Target page ID. source_ref: Ref ID of the element to drag. target_ref: Ref ID of the drop target. humanize: Use human-like mouse movement instead of direct drag_to. duration_ms: Approximate humanized drag duration, clamped to 250-5000 ms. steps: Number of mouse movement points, clamped to 8-80. fallback: Retry with Playwright drag_to if humanized drag fails.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"page_id": "<page_id>",
"source_ref": "<source_ref>",
"target_ref": "<target_ref>"
},
"name": "browser_drag"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page_id | Yes | ||
| source_ref | Yes | ||
| target_ref | Yes | ||
| humanize | No | ||
| duration_ms | No | ||
| steps | No | ||
| fallback | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||