Struct HttpError 

#[non_exhaustive]
pub struct HttpError(/* private fields */);

HTTP transport error reported by the underlying HTTP client.

The inner third-party error type is private; callers diagnose the failure via the accessor methods, all of which return primitive types so this crate can swap or bump the underlying HTTP client without breaking the public API.

Implementations

impl HttpError

pub fn is_timeout(&self) -> bool

true if the request timed out before a response was received.

pub fn is_connect(&self) -> bool

true if the underlying connection could not be established (DNS failure, TCP refused, TLS handshake failure, etc.).

pub fn is_builder(&self) -> bool

true if the error originated in the request builder (URL parse failure, invalid header construction at build time, etc.).

pub fn is_redirect(&self) -> bool

true if the error is a redirect-loop or too-many-redirects failure.

pub fn is_status(&self) -> bool

true if the error originated from a non-success HTTP status.

pub fn is_request(&self) -> bool

true if the error happened while sending the request body.

pub fn is_body(&self) -> bool

true if the error happened while receiving / decoding the response body.

pub fn is_decode(&self) -> bool

true if the response body could not be decoded as the requested representation (e.g. JSON parse failure inside the transport layer).

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

HTTP status code if the error came from a non-success response; None for transport-level failures (timeout, connection refused, etc.).

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

URL the request was sent to, if known. Returned as an owned String to avoid leaking the underlying transport’s Url type into this crate’s public API.

Trait Implementations

impl Debug for HttpError

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

Formats the value using the given formatter.

impl Display for HttpError

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

Formats the value using the given formatter.

impl Error for HttpError

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.