Enum FailureCode 

#[non_exhaustive]
pub enum FailureCode {
    ElementNotFound,
    NotVisible,
    NotEnabled,
    Ambiguous,
    Timeout,
    AssertionFailed,
    AppNotRunning,
    SimulatorNotBooted,
    TapMissed,
    CoordinateSpaceMismatch,
    DriverError,
}

All failure codes smix surfaces back to the SDK / MCP / CLI (SCREAMING_SNAKE_CASE wire).

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

ElementNotFound

Selector matched zero elements in the visible tree.

NotVisible

Element matched but failed the visibility filter.

NotEnabled

Element matched but enabled = false.

Ambiguous

Selector matched multiple elements (when uniqueness was required).

Timeout

Operation exceeded the implicit-wait budget.

AssertionFailed

expect assertion (e.g. toHaveText) did not hold.

AppNotRunning

Target app exited or never launched.

SimulatorNotBooted

Simulator device is not booted.

TapMissed

The touch was synthesised, and it did not land inside the element the selector matched.

Distinct from ElementNotFound because the two send a reader somewhere different: not-found means fix the selector, missed means the element was there and the touch went elsewhere — a stale frame, or something moved between the tree fetch and the tap.

CoordinateSpaceMismatch

The screen is described in one coordinate space and the touch would be delivered in another, so no aim can land where the tree says the element is.

Distinct from TapMissed, and the distinction is the whole point: a miss says the element was there and the touch went elsewhere, which invites another attempt with a better point. There is no better point here — whatever is passed gets recomputed against the app’s frame and then read against the device’s. Retrying is the trap, and the consumer who found this spent an afternoon in it.

DriverError

Catch-all for runner / driver / IO failures.

Trait Implementations

impl Clone for FailureCode

fn clone(&self) -> FailureCode

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for FailureCode

impl Debug for FailureCode

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for FailureCode

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for FailureCode

impl Hash for FailureCode

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for FailureCode

fn eq(&self, other: &FailureCode) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for FailureCode

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for FailureCode