Enum Error 

pub enum Error {
    Config {
        message: String,
    },
    Profile {
        message: String,
    },
    FirefoxNotFound {
        path: PathBuf,
    },
    ProcessLaunchFailed {
        message: String,
    },
    Connection {
        message: String,
    },
    ConnectionTimeout {
        timeout_ms: u64,
    },
    ConnectionClosed,
    UnknownCommand {
        command: String,
    },
    InvalidArgument {
        message: String,
    },
    Protocol {
        message: String,
    },
    ElementNotFound {
        selector: String,
        tab_id: TabId,
        frame_id: FrameId,
    },
    StaleElement {
        element_id: ElementId,
    },
    FrameNotFound {
        frame_id: FrameId,
    },
    TabNotFound {
        tab_id: TabId,
    },
    ScriptError {
        message: String,
    },
    Timeout {
        operation: String,
        timeout_ms: u64,
    },
    RequestTimeout {
        request_id: RequestId,
        timeout_ms: u64,
    },
    InterceptNotFound {
        intercept_id: String,
    },
    SessionNotFound {
        session_id: SessionId,
    },
    Io(Error),
    Json(Error),
    WebSocket(Error),
    ChannelClosed(RecvError),
}

Main error type for the crate.

Each variant includes relevant context for debugging. Error codes match ARCHITECTURE.md Section 6.2.

Variants

Config

Configuration error.

Returned when driver configuration is invalid.

Fields

message: String

Description of the configuration error.

Profile

Profile error.

Returned when Firefox profile creation or setup fails.

Fields

message: String

Description of the profile error.

FirefoxNotFound

Firefox binary not found at path.

Returned when the specified Firefox binary does not exist.

Fields

path: PathBuf

Path where Firefox was expected.

ProcessLaunchFailed

Failed to launch Firefox process.

Returned when Firefox process fails to start.

Fields

message: String

Description of the launch failure.

Connection

WebSocket connection failed.

Returned when WebSocket connection cannot be established.

Fields

message: String

Description of the connection error.

ConnectionTimeout

Connection timeout waiting for extension.

Returned when extension does not connect within timeout period.

Fields

timeout_ms: u64

Milliseconds waited before timeout.

ConnectionClosed

WebSocket connection closed unexpectedly.

Returned when connection is lost during operation.

UnknownCommand

Unknown command method.

Returned when extension receives unrecognized command.

Fields

command: String

The unrecognized command method.

InvalidArgument

Invalid argument in command params.

Returned when command parameters are invalid.

Fields

message: String

Description of the invalid argument.

Protocol

Protocol violation or unexpected response.

Returned when protocol message format is invalid.

Fields

message: String

Description of the protocol violation.

ElementNotFound

Element not found by selector.

Returned when CSS selector matches no elements.

Fields

selector: String

CSS selector used.

tab_id: TabId

Tab where search was performed.

frame_id: FrameId

Frame where search was performed.

StaleElement

Element is stale (no longer in DOM).

Returned when element reference is no longer valid.

Fields

element_id: ElementId

The stale element’s ID.

FrameNotFound

Frame not found.

Returned when frame ID does not exist.

Fields

frame_id: FrameId

The missing frame ID.

TabNotFound

Tab not found.

Returned when tab ID does not exist.

Fields

tab_id: TabId

The missing tab ID.

ScriptError

JavaScript execution error.

Returned when script execution fails in browser.

Fields

message: String

Error message from script execution.

Timeout

Operation timeout.

Returned when operation exceeds timeout duration.

Fields

operation: String

Description of the operation that timed out.

timeout_ms: u64

Milliseconds waited before timeout.

RequestTimeout

Command request timeout.

Returned when WebSocket request times out.

Fields

request_id: RequestId

The request ID that timed out.

timeout_ms: u64

Milliseconds waited before timeout.

InterceptNotFound

Network intercept not found.

Returned when intercept ID does not exist.

Fields

intercept_id: String

The missing intercept ID.

SessionNotFound

Session not found in connection pool.

Returned when session ID does not exist in the pool.

Fields

session_id: SessionId

The missing session ID.

Io(Error)

IO error.

Json(Error)

JSON serialization error.

WebSocket(Error)

WebSocket error.

ChannelClosed(RecvError)

Channel receive error.

Implementations

impl Error

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

Creates a configuration error.

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

Creates a profile error.

pub fn firefox_not_found(path: impl Into<PathBuf>) -> Self

Creates a Firefox not found error.

pub fn process_launch_failed(err: IoError) -> Self

Creates a process launch failed error.

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

Creates a connection error.

pub fn connection_timeout(timeout_ms: u64) -> Self

Creates a connection timeout error.

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

Creates a protocol error.

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

Creates an invalid argument error.

pub fn element_not_found( selector: impl Into<String>, tab_id: TabId, frame_id: FrameId, ) -> Self

Creates an element not found error.

pub fn stale_element(element_id: ElementId) -> Self

Creates a stale element error.

pub fn frame_not_found(frame_id: FrameId) -> Self

Creates a frame not found error.

pub fn tab_not_found(tab_id: TabId) -> Self

Creates a tab not found error.

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

Creates a script error.

pub fn timeout(operation: impl Into<String>, timeout_ms: u64) -> Self

Creates a timeout error.

pub fn request_timeout(request_id: RequestId, timeout_ms: u64) -> Self

Creates a request timeout error.

pub fn intercept_not_found(intercept_id: impl Into<String>) -> Self

Creates an intercept not found error.

pub fn session_not_found(session_id: SessionId) -> Self

Creates a session not found error.

impl Error

pub fn is_timeout(&self) -> bool

Returns true if this is a timeout error.

pub fn is_element_error(&self) -> bool

Returns true if this is an element error.

pub fn is_connection_error(&self) -> bool

Returns true if this is a connection error.

pub fn is_recoverable(&self) -> bool

Returns true if this error is recoverable.

Recoverable errors may succeed on retry.

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: IoError) -> 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.

impl From<Error> for Error

fn from(source: WsError) -> Self

Converts to this type from the input type.

impl From<RecvError> for Error

fn from(source: RecvError) -> Self

Converts to this type from the input type.