Enum Error 

pub enum Error {
    Http {
        status: StatusCode,
        message: String,
        response: Box<HttpErrorResponse>,
    },
    Transport(Box<dyn StdError + Send + Sync>),
    Tls(Box<dyn StdError + Send + Sync>),
    Timeout,
    TooManyRedirects {
        max: u32,
    },
    InvalidRedirectLocation,
    InvalidUri(String),
    InvalidRequest(String),
    BodyParse(BodyError),
    ResponseBodyTooLarge {
        limit: usize,
    },
    Cookie(CookieErrorKind),
    OAuth2(OAuth2ErrorKind),
    Download(DownloadErrorKind),
    WebSocket(WebSocketErrorKind),
    Proxy(ProxyErrorKind),
    Io(Error),
    Other(Box<dyn StdError + Send + Sync>),
}

Unified error type for all zenwave operations.

Variants

Http

HTTP server returned an error response (4xx/5xx status code).

This represents a successful HTTP connection where the server returned an error status. The response body may contain additional error details that can be deserialized using Error::deserialize_http_error.

Fields

status: StatusCode

HTTP status code

message: String

Error message (extracted from response body or default message)

response: Box<HttpErrorResponse>

Full HTTP error response details

Transport(Box<dyn StdError + Send + Sync>)

Network transport layer error (connection failed, DNS resolution failed, etc.).

Tls(Box<dyn StdError + Send + Sync>)

TLS/SSL error.

Timeout

Request timed out.

TooManyRedirects

Too many redirects were followed.

Fields

max: u32

Maximum number of redirects allowed

InvalidRedirectLocation

Invalid redirect Location header.

InvalidUri(String)

URI parsing error.

InvalidRequest(String)

Request construction error (invalid headers, body, etc.).

BodyParse(BodyError)

Response body parsing error (JSON, form, string, etc.).

ResponseBodyTooLarge

Response body exceeded the caller-provided in-memory limit.

Fields

limit: usize

Maximum response body size accepted by the caller.

Cookie(CookieErrorKind)

Cookie management error.

OAuth2(OAuth2ErrorKind)

OAuth2 authentication error.

Download(DownloadErrorKind)

File download error.

WebSocket(WebSocketErrorKind)

WebSocket error.

Proxy(ProxyErrorKind)

The proxy between the client and the target refused or broke the connection.

Io(Error)

I/O error (file operations, etc.).

Other(Box<dyn StdError + Send + Sync>)

Other uncategorized error.

Implementations

impl Error

pub const fn is_network_error(&self) -> bool

Check if this is a network transport error.

pub const fn is_timeout(&self) -> bool

Check if this is a timeout error.

pub fn is_client_error(&self) -> bool

Check if this is a client error (4xx HTTP status).

pub fn is_server_error(&self) -> bool

Check if this is a server error (5xx HTTP status).

pub const fn is_redirect_error(&self) -> bool

Check if this is a redirect-related error.

pub const fn is_request_error(&self) -> bool

Check if this is a request construction error.

pub fn response_body(&self) -> Option<&str>

Get the response body text (if this is an HTTP error).

pub const fn response(&self) -> Option<&Response>

Get the full HTTP response (if this is an HTTP error).

pub fn deserialize_http_error<T: DeserializeOwned>(&self) -> Option<T>

Attempt to deserialize the HTTP error response body as a specific type.

This is useful for APIs that return structured error responses.

Example

use serde::Deserialize;
use zenwave::Client;

#[derive(Deserialize)]
struct ApiError {
    code: String,
    message: String,
}

match client.get("https://api.example.com/data") {
    Err(e) => {
        if let Some(api_err) = e.deserialize_http_error::<ApiError>() {
            println!("API error: {} - {}", api_err.code, api_err.message);
        }
    }
    Ok(builder) => {
        let _resp = builder.await?;
    }
}

pub const fn kind(&self) -> ErrorKind

Get the error category/kind.

Useful for logging and monitoring.

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<CacheError> for Error

fn from(err: CacheError) -> Self

Converts to this type from the input type.

impl From<CookieError> for Error

fn from(err: CookieError) -> Self

Converts to this type from the input type.

impl From<CookieErrorKind> for Error

fn from(source: CookieErrorKind) -> Self

Converts to this type from the input type.

impl From<DownloadErrorKind> for Error

fn from(source: DownloadErrorKind) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(source: BodyError) -> 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<H> From<FollowRedirectError<H>> for Error

where H: HttpError + Into<Self>,

fn from(err: FollowRedirectError<H>) -> Self

Converts to this type from the input type.

impl<E, M> From<MiddlewareError<E, M>> for Error

where E: Into<Self>, M: Into<Self>,

fn from(err: MiddlewareError<E, M>) -> Self

Converts to this type from the input type.

impl<H> From<OAuth2Error<H>> for Error

where H: HttpError + Into<Self>,

fn from(err: OAuth2Error<H>) -> Self

Converts to this type from the input type.

impl From<OAuth2ErrorKind> for Error

fn from(source: OAuth2ErrorKind) -> Self

Converts to this type from the input type.

impl From<ProxyErrorKind> for Error

fn from(source: ProxyErrorKind) -> Self

Converts to this type from the input type.

impl From<TimeoutError> for Error

fn from(_: TimeoutError) -> Self

Converts to this type from the input type.

impl From<WebSocketError> for Error

fn from(err: WebSocketError) -> Self

Converts to this type from the input type.

impl From<WebSocketErrorKind> for Error

fn from(source: WebSocketErrorKind) -> Self

Converts to this type from the input type.

impl HttpError for Error

fn status(&self) -> StatusCode

Returns the HTTP status code associated with this error.