Visitar URL original
feat: add drag command for drag-and-drop gestures (#1203) by AfzalivE · Pull Request #3453 · mobile-dev-inc/Maestro · GitHub
Skip to content

feat: add drag command for drag-and-drop gestures (#1203) - #3453

Open
AfzalivE wants to merge 19 commits into
mobile-dev-inc:mainfrom
AfzalivE:feat/1203-drag-drop
Open

feat: add drag command for drag-and-drop gestures (#1203)#3453
AfzalivE wants to merge 19 commits into
mobile-dev-inc:mainfrom
AfzalivE:feat/1203-drag-drop

Conversation

@AfzalivE

@AfzalivE AfzalivE commented Jul 21, 2026 •
edited
Loading

Copy link
Copy Markdown

Proposed changes

Branched from from #2978

Implements a new 'drag' command that enables drag-and-drop gestures and
item reordering in mobile apps.

Closes #1203

Supported syntax

  • drag from/to by element id or text
  • drag from/to by percentage coordinates
  • drag from point with offset
  • configurable duration and press duration (for longpress before drag)

Example usage

# Drag by element text
- drag:
    from:
      text: ".*Item 3.*"
    to:
      text: ".*Item 1.*"
    duration: 3000
    pressDuration: 1000

# Drag by percentage coordinates
- drag:
    from: "50%, 30%"
    to: "50%, 70%"
    pressDuration: 1000

# Drag with offset
- drag:
    from: "50%, 30%"
    offset: "0%, 40%"
    pressDuration: 1000

Status

Platform Status
Android ✅ Fully working
iOS + React Native ✅ Fully working
iOS + Flutter ⚠️ Known issue (see below)
Web (CDP/Selenium) ✅ Implemented

iOS + Flutter limitation

There is a known bug in Flutter's ReorderableListView + item Semantics where element coordinates become invalid after the first drag operation. This is a Flutter/iOS accessibility bug tracked in flutter/flutter#100946, not a Maestro issue. Created flutter/flutter#189686 to fix this.

Testing

Does this need e2e tests?

Added.

Issues fixed

Closes #1203

AfzalivE
AfzalivE commented Jul 21, 2026
View reviewed changes
Comment thread maestro-client/src/main/java/maestro/drivers/AndroidDriver.kt Resolved
@AfzalivE AfzalivE mentioned this pull request Jul 21, 2026
Open
Fishbowler
Fishbowler reviewed Jul 21, 2026
View reviewed changes

@Fishbowler Fishbowler left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

As well as the failing e2e test, also spotted that the new test isn't running

Comment thread e2e/demo_app/.maestro/commands/drag_long_press.yaml Resolved
boorad and others added 17 commits July 28, 2026 11:37
@boorad @AfzalivE
feat: add drag command for drag-and-drop gestures (mobile-dev-inc#1203)
28e1102 
Implements a new 'drag' command that enables drag-and-drop gestures and
item reordering in mobile apps.

Supported syntax:
- drag from/to by element id or text
- drag from/to by percentage coordinates
- drag from point with offset
- configurable duration

Status:
- Android: fully working
- iOS + React Native: fully working
- iOS + Flutter: known bug where element coordinates become invalid
  after first drag (Flutter accessibility issue, not Maestro)

See DRAG_ISSUE_FLUTTER_IOS.md for detailed investigation of the
Flutter+iOS issue.
# Conflicts:
#	.gitignore
@boorad @AfzalivE
refactor: extract shared drag gesture utility and cleanup
af34d06 
- Remove unused 'steps' variable in AndroidDriver.drag()
- Extract duplicate drag implementation from WebDriver and CdpWebDriver
  to shared SeleniumGestures.performDrag() utility
- Add DRAG_LONG_PRESS_DURATION_MS constant (1000ms) for clarity
@boorad @AfzalivE
test: split drag tests into text and percentage variants
56e944c 
- Rename drag_test.yaml to drag_text.yaml (element selector based)
- Add drag_pcts.yaml (percentage coordinate based)
- Add clearState to both tests for consistent starting state
- Add warning about percentage-based tests being device-specific
@boorad @AfzalivE
docs: add XCUICoordinate approach from Appium to drag issue notes
9edb736
@boorad @AfzalivE
refactor: revert unrelated tap() refactor and whitespace-only changes
f7c08ea
@boorad @AfzalivE
refactor: remove dead dragByText code and commented-out text-based dr…
b4a38c2 
…ag path
@boorad @AfzalivE
refactor: simplify YamlDrag deserializer and clarify Flutter/iOS issu…
cd05ca5 
…e language
@boorad @AfzalivE
test: add YAML parsing and integration tests for drag command
4e2900d
@boorad @AfzalivE
chore: remove DRAG_ISSUE_FLUTTER_IOS.md (moved to issue mobile-dev-in…
617589d 
…c#2984)
@Fishbowler @AfzalivE
Post-rebase fixes
be03599
@Fishbowler @AfzalivE
Fix e2e tests
3d4e87c
@Fishbowler @AfzalivE
Revert some more whitespace-only changes
8aa8af1
@Fishbowler @AfzalivE
Add a web e2e test
fa2ef7c
@Fishbowler @AfzalivE
Update e2e
113592b
@AfzalivE
Add drag press duration
fc39c42
@AfzalivE
Honor drag press duration on Android
0637e8f
@AfzalivE
Fix drag command E2E coverage
3b774d5 
Move the long-press regression into the command suite so PR checks
exercise pressDuration. Adjust the percentage target to match the CI
layout.
@AfzalivE
AfzalivE force-pushed the feat/1203-drag-drop branch from 40a8001 to 3b774d5 Compare July 28, 2026 15:37
AfzalivE added 2 commits July 28, 2026 14:22
@AfzalivE
Increase pressDuration to fix flakiness
78bf889
@AfzalivE
Keep Android drag gesture continuous
0c330f4 
A shell swipe starts a second pointer stream, cancelling the held
pointer before movement. Emit interpolated motion events directly so
custom press durations remain one DOWN, MOVE, and UP sequence.
@AfzalivE

AfzalivE commented Jul 28, 2026 •
edited
Loading

Copy link
Copy Markdown
Author

drag_long_press was failing on Android because I assumed that having two consecutive DOWN events would be fine but actually, a second DOWN event cancels the first one so the long-press and swipe were separate.

On Android, draganddrop command does long-press for the duration of the long-press timeout already (ref) but Flutter's LongPressDraggable allows modifying the long-press delay, which won't be accounted for via draganddrop hence the motionevent based drag when pressDuration is specified.

@AfzalivE

AfzalivE commented Jul 29, 2026

Copy link
Copy Markdown
Author

@Fishbowler Fixed the failing test and included the new one. Sorry for the delay, had a work trip last week.

@AfzalivE

AfzalivE commented Sep 1, 2026

Copy link
Copy Markdown
Author

Btw, the ReorderableListView semantics bugfix for Flutter got merged 🎉

@Fishbowler Fishbowler added the awaiting maestro 3.0 Driver work: on hold until after Maestro 3.0 label Oct 23, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@Fishbowler Fishbowler Fishbowler left review comments

At least 1 approving review is required to merge this pull request.

Assignees

No one assigned

Labels

awaiting maestro 3.0 Driver work: on hold until after Maestro 3.0

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

[Enhancement] Hold and swipe/drag to reorder items

3 participants

@AfzalivE @Fishbowler @boorad