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.

pub fn kind(&self) -> HttpErrorKind

Classify the error into a single category (bd:JMAP-6r7c.34).

The 8 is_* boolean accessors are useful when a caller wants to test for a specific category, but they leave the caller writing a chained-if-else dispatch with undocumented mutual relationships (“can is_status and is_decode both be true?”). This method returns a single HttpErrorKind so a caller can match on it once.

Precedence (highest first) when multiple predicates could arguably apply: Timeout, Connect, Redirect, Status, RequestBody, ResponseBody, Decode, Builder, Other. Status takes precedence over body/decode because reqwest sets is_status precisely when the failure is “the HTTP server returned a non-success status code”; in that case the body or decode flag may also be set, but the most-actionable classification for a caller is the status code itself.

This method does not return retriability advice — the same Status(429) may be retriable or fatal depending on the Retry-After header value, and the same Connect may mean “DNS not yet warm” (retry) or “host is down” (give up). Make the retriability decision at the call site, using the kind as input.

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.