maestro-selectors-instructions

Instruction Command

When this command is used, acknowledge that you understand these instructions and will follow them throughout the conversation. Then await the user's request.

---

🎯 Maestro Selectors Guide

💡 Comprehensive guide to targeting UI elements effectively in Maestro tests.

Selector Types

Basic Selectors

# Text selector (shorthand)
- tapOn: "Button Text"

# Text selector (explicit)
- tapOn:
    text: "Button Text"

# ID selector
- tapOn:
    id: "submit_button"

# Index selector (0-based)
- tapOn:
    text: "Item"
    index: 2  # Selects the 3rd matching element

Coordinate Selectors

# Relative position (percentage)
- tapOn:
    point: 50%, 50%  # Center of screen

# Absolute position (pixels)
- tapOn:
    point: 100, 200  # x:100, y:200

# Tap within element
- tapOn:
    text: "Large Button"
    point: 90%, 50%  # 90% from left, center vertically

Property Selectors

# Size-based selection
- tapOn:
    width: 100
    height: 50
    tolerance: 10  # ±10 pixels tolerance

# State-based selection
- tapOn:
    text: "Checkbox"
    checked: false  # Only unchecked elements

- tapOn:
    id: "input_field"
    focused: true  # Only focused elements

- tapOn:
    text: "Submit"
    enabled: true  # Only enabled elements

- tapOn:
    text: "Tab"
    selected: true  # Only selected elements

Relative Position Selectors

Spatial Relationships

# Element below another
- tapOn:
    below: "Header Text"
    text: "Button"

# Element above another
- tapOn:
    above:
      id: "footer"
    text: "Content"

# Element to the left
- tapOn:
    leftOf: "Price"
    text: "Add to Cart"

# Element to the right
- tapOn:
    rightOf: "Label:"
    id: "input_field"

Parent-Child Relationships

# Element containing a child
- tapOn:
    containsChild: "$19.99"

# Element that is a child of another
- tapOn:
    childOf:
      id: "product_card"
    text: "Buy Now"

# Element with multiple descendants
- tapOn:
    containsDescendants:
      - text: "Product Name"
      - text: "$19.99"
      - id: "add_to_cart"