Struct Error 

pub struct Error { /* private fields */ }

The Errors that may occur when processing a Request.

Note: Errors may include the full URI used to make the Request. If the URI contains sensitive information (e.g. an API key as a query parameter), be sure to remove it (without_uri)

Implementations

impl Error

pub fn uri(&self) -> Option<&Uri>

Returns a possible URI related to this error.

Examples

// displays last stop of a redirect loop
let response = hpx::get("http://site.with.redirect.loop").send().await;
if let Err(e) = response {
    if e.is_redirect() {
        if let Some(final_stop) = e.uri() {
            println!("redirect loop at {}", final_stop);
        }
    }
}

pub fn uri_mut(&mut self) -> Option<&mut Uri>

Returns a mutable reference to the URI related to this error

This is useful if you need to remove sensitive information from the URI (e.g. an API key in the query), but do not want to remove the URI entirely.

pub fn with_uri(self, uri: Uri) -> Self

Add a uri related to this error (overwriting any existing)

pub fn without_uri(self) -> Self

Strip the related uri from this error (if, for example, it contains sensitive information)

pub fn is_builder(&self) -> bool

Returns true if the error is from a type Builder.

pub fn is_redirect(&self) -> bool

Returns true if the error is from a RedirectPolicy.

pub fn is_status(&self) -> bool

Returns true if the error is from Response::error_for_status.

pub fn is_timeout(&self) -> bool

Returns true if the error is related to a timeout.

pub fn is_request(&self) -> bool

Returns true if the error is related to the request

pub fn is_connect(&self) -> bool

Returns true if the error is related to connect

pub fn is_proxy_connect(&self) -> bool

Returns true if the error is related to proxy connect

pub fn is_connection_reset(&self) -> bool

Returns true if the error is related to a connection reset.

pub fn is_body(&self) -> bool

Returns true if the error is related to the request or response body

pub fn is_tls(&self) -> bool

Returns true if the error is related to TLS

pub fn is_decode(&self) -> bool

Returns true if the error is related to decoding the response’s body

pub fn is_upgrade(&self) -> bool

Returns true if the error is related to upgrading the connection

pub fn is_websocket(&self) -> bool

Available on crate features ws-yawc or ws-fastwebsockets only.

Returns true if the error is related to WebSocket operations

pub fn status(&self) -> Option<StatusCode>

Returns the status code, if the error was generated from a response.

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, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Error for Error

fn source(&self) -> Option<&(dyn StdError + '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.