For the complete documentation index, see llms.txt. This page is also available as Markdown.

MAP_ACTION

Coordinate-based taps, drags and pinches for map surfaces, canvases and sliders — the least deterministic command in Drizz.

MAP_ACTION acts on the visible surface rather than on a labeled element. It covers maps, canvases and sliders, and applies when normal targeting has failed.

Platforms

Tap : Android · iOS Drag : Android · iOS

Pinch / zoom

Specific Android emulators only. Not iOS

Prerequisites

  • A connected device or emulator

  • An open test file

  • A target element with no visible label and no clean bounding box, or a gesture that isn't a tap

  • The surface fully rendered before the step runs

Copy this

OPEN_APP com.shopease.android
Wait Until 5 Seconds

Tap on Filters
Wait Until 2 Seconds

MAP_ACTION Drag the price slider from 200 to 800
Validate that the price range shows 800
Tap on Apply

Write a MAP_ACTION step

  1. Confirm the element has no visible label. If it has one, use Tap.

  2. Add a Wait above the step so the surface is fully rendered.

  3. Start the line with MAP_ACTION, then describe the gesture in plain English.

  4. State both ends of a drag — where it starts and where it ends.

  5. Add a Validate on the next line for the resulting state.

  6. Run the test several times and confirm the same cell resolves on each run.

Syntax

Element
Form
Notes

Keyword

MAP_ACTION

Space separator. MAP_ACTION: also works and appears in older scripts — write the space form in anything new

Gesture

Tap on <description> · Drag <from> to <to>

The / palette lists two entries, MAP_ACTION Tap and MAP_ACTION Drag

Drag path

from <start> to <end>

Both ends required

Tap

For map markers, canvas controls and boxes with no label of their own.

Drag

For sliders, seekbars, time pickers, map panning and swipe-to-confirm controls. State where the drag starts and where it ends.

Directional phrasing that works: from left to right, from bottom to top, from top right to center of screen.

Pinch and zoom

Platform support

Gesture
Support
Notes

Tap

Dispatches the same primitive as a normal tap

Drag

Dispatches the same primitive as a normal swipe

Pinch / zoom

Specific emulators only

Not available on every Android device target

Gesture
Support
Notes

Tap

Dispatches the same primitive as a normal tap

Drag

Dispatches the same primitive as a normal swipe

Pinch / zoom

Not implemented on iOS. Drop pinch from cross-platform tests, or gate it

Determinism

MAP_ACTION overlays a numbered grid on the screen and picks a cell. That is what lets it work where element targeting can't. Two runs of the same script can select different cells, most often when a tappable element straddles a grid boundary.

A Validate on the next line turns a wrong cell into a visible failure in the report instead of a failure three screens later.

Common mistakes

What you wrote
What happens

MAP_ACTION Tap on Continue when Continue has a visible label

A deterministic tap replaced with a grid guess, for no benefit

MAP_ACTION Drag the slider with no start and end

The drag has no defined path. State both ends

MAP_ACTION pinch to zoom in in a suite that runs on iOS

The step doesn't run there. Gate it, or drop pinch from cross-platform tests

No Validate after a MAP_ACTION

A wrong cell passes silently and the test fails somewhere unrelated

MAP_ACTION on a normal list or form

Grid targeting on a screen that has a perfectly good element tree. Use Tap and Scroll

A MAP_ACTION that worked once, trusted without a retry check

Repeat runs can pick a different cell. Run it several times before you rely on it

MAP_ACTION issued while the map is still rendering

The grid is drawn over a half-loaded surface. Wait for the screen to settle first

Next


Last updated: 6 August 2026

Last updated

Was this helpful?