gesture-scroll
Scroll content in Chromium apps by dispatching mouse-wheel events at a normalized anchor point. Use when content is off-screen or a list needs scrolling.
Instructions
Scroll content in a Chromium app by dispatching mouse-wheel events at a point. Anchor x/y are normalized 0.0–1.0 (fractions of the window, not pixels), same coordinate space as gesture-tap and describe. Deltas are fractions of the window too: deltaY 0.5 scrolls down half a window; negative scrolls back up. Use when content is below/above the fold (describe shows off-screen elements with zero height) or a list needs scrolling. Chromium only — on iOS/Android use gesture-swipe. Returns { scrolled: true, timestampMs }. Fails if the Chromium CDP session is not reachable for the given device.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| x | Yes | Anchor x: normalized 0.0–1.0 (fraction of window width, not pixels). The wheel events land here — put it over the element you want to scroll. | |
| y | Yes | Anchor y: normalized 0.0–1.0 (fraction of window height, not pixels). | |
| udid | Yes | Target Chromium device id from `list-devices` (chromium-cdp-<port>). | |
| deltaX | No | Horizontal scroll distance as a fraction of the window width (e.g. 0.5 = half a window). Positive scrolls content right (reveals content to the right). | |
| deltaY | No | Vertical scroll distance as a fraction of the window height (e.g. 0.5 = half a window). Positive scrolls content down (reveals content below), like rolling a mouse wheel toward you. | |
| durationMs | No | Spread the scroll over this many milliseconds in wheel-event steps (default 300) so scroll handlers fire progressively. |