Enum Error 

pub enum Error {
    ElementNotFound {
        xpath: String,
    },
    AmbiguousSelector {
        xpath: String,
        count: usize,
    },
    InvalidSelector {
        xpath: String,
        reason: String,
    },
    ElementStale {
        xpath: String,
        bus: String,
        path: String,
    },
    Atspi {
        message: String,
        source: Option<Box<dyn Error + Send + Sync + 'static>>,
    },
    Zbus(Error),
    Io(Error),
    Timeout(String),
    Cancelled,
    Process {
        message: String,
        source: Option<Box<dyn Error + Send + Sync + 'static>>,
    },
    Screenshot {
        message: String,
        source: Option<Box<dyn Error + Send + Sync + 'static>>,
    },
}

Errors that can occur during a waydriver session.

Variants

ElementNotFound

Fields

xpath: String

AmbiguousSelector

Fields

xpath: String

count: usize

InvalidSelector

Fields

xpath: String

reason: String

ElementStale

Fields

xpath: String

bus: String

path: String

Atspi

AT-SPI introspection / action failure.

message carries human-readable context ("<operation>: <details>"); source carries the typed underlying error (commonly zbus::Error) when one exists, so callers can downcast via std::error::Error::source. Construct via Error::atspi / Error::atspi_with.

Fields

message: String

source: Option<Box<dyn Error + Send + Sync + 'static>>

Zbus(Error)

Io(Error)

Timeout(String)

Cancelled

The session’s cancellation token was triggered while this operation was in flight. Typically means kill_session was called on an MCP session with in-flight tool calls — the tool bails out of any auto-wait loop so kill can proceed without waiting for the natural timeout.

Process

Subprocess / IPC / mutex-poisoning failure. See Error::Atspi for the field semantics; construct via Error::process / Error::process_with.

Fields

message: String

source: Option<Box<dyn Error + Send + Sync + 'static>>

Screenshot

Screenshot / video-capture failure. See Error::Atspi for the field semantics; construct via Error::screenshot / Error::screenshot_with.

Fields

message: String

source: Option<Box<dyn Error + Send + Sync + 'static>>

Implementations

impl Error

pub fn atspi(message: impl Into<String>) -> Self

AT-SPI failure with a free-form message and no underlying source.

pub fn atspi_with<E>(operation: impl Display, source: E) -> Self

where E: Error + Send + Sync + 'static,

AT-SPI failure caused by an underlying error. The Display of source is appended to operation so the rendered message stays "AT-SPI: <operation>: <source>", and the typed source is preserved for std::error::Error::source.

pub fn process(message: impl Into<String>) -> Self

Process / IPC failure with a free-form message and no source.

pub fn process_with<E>(operation: impl Display, source: E) -> Self

where E: Error + Send + Sync + 'static,

Process / IPC failure caused by an underlying error. See Error::atspi_with for the message-formatting rules.

pub fn screenshot(message: impl Into<String>) -> Self

Screenshot / capture failure with a free-form message and no source.

pub fn screenshot_with<E>(operation: impl Display, source: E) -> Self

where E: Error + Send + Sync + 'static,

Screenshot / capture failure caused by an underlying error. See Error::atspi_with for the message-formatting rules.

Trait Implementations

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<Error> for Error

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(source: Error) -> Self

Converts to this type from the input type.