find

This tool on every surface: CLI · MCP · Python · JavaScript · Go · Java · .NET

Find elements matching a locator and return their refs, without tapping. These call app_find.

find

find(locator: string): Promise<Element[]>

Examples

Find every button on screen, without tapping

const buttons = await device.find('role=button')
console.log(buttons.map((b) => b.label))

The same call from the command line, mobium find role=button, printed on an Android 15 emulator:

@e2 Profile picture, double tap to open Google Account (button)
@e3 Search settings (button)
(no ref)  [53,599][200,736]
@e5 Network & internet Mobile, Wi‑Fi, hotspot (button)
@e6 Connected devices Bluetooth, pairing (button)
@e7 Apps Assistant, recent apps, default apps (button)
@e8 Notifications Notification history, conversations (button)
@e9 Battery 100% (button)
@e10 Storage 51% used - 7.85 GB free (button)
@e11 Sound & vibration Volume, haptics, Do Not Disturb (button)

mobium find role=button on an Android 15 emulator