Struct RequestError 

pub struct RequestError(/* private fields */);

A transport-level failure from the underlying HTTP client.

Transparent over the underlying client error: it renders and sources through to it, and derefs to it so its classification methods (for example is_timeout) are callable without naming the client crate.

Methods from Deref<Target = Error>

pub fn url(&self) -> Option<&Url>

Returns a possible URL related to this error.

Examples

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

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_body(&self) -> bool

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

pub fn is_decode(&self) -> bool

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

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

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

pub fn is_upgrade(&self) -> bool

Returns true if the error is related to a protocol upgrade request

Trait Implementations

impl Debug for RequestError

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

Formats the value using the given formatter.

impl Deref for RequestError

type Target = Error

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl Display for RequestError

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

Formats the value using the given formatter.

impl Error for RequestError

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 RequestError

fn from(source: Error) -> Self

Converts to this type from the input type.