Enum HttpErrorKind 

#[non_exhaustive]
pub enum HttpErrorKind {
    Timeout,
    Connect,
    Redirect,
    Status(u16),
    RequestBody,
    ResponseBody,
    Decode,
    Builder,
    Other,
}

Classification of an HttpError returned by HttpError::kind.

A coarse partition over the failure modes reqwest reports. Use this when a caller wants to dispatch on the error category in a single match; the HttpError::is_timeout / HttpError::is_connect boolean accessors remain available for callers that test for one specific category.

#[non_exhaustive] so new variants may be added in minor releases without breaking callers.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Timeout

Request timed out before a response was received (HttpError::is_timeout).

Connect

Underlying connection could not be established — DNS failure, TCP refused, TLS handshake failure (HttpError::is_connect).

Redirect

Redirect loop or too-many-redirects failure (HttpError::is_redirect).

Status(u16)

Server returned a non-success HTTP status. The payload is the status code as u16 (e.g. 404, 429, 503). 401 / 403 are not surfaced here — they are caught earlier and produce ClientError::AuthFailed.

RequestBody

Error happened while sending the request body (HttpError::is_request).

ResponseBody

Error happened while receiving the response body (HttpError::is_body).

Decode

Response body could not be decoded as the requested representation (e.g. JSON parse failure inside the transport layer) (HttpError::is_decode).

Builder

Error originated in the request builder — URL parse failure, invalid header construction at build time, etc. (HttpError::is_builder). Indicates a caller bug.

Other

Categorisation did not match any of the predicates above. May appear for transport-level errors that reqwest reports without setting any of the typed predicates.

Trait Implementations

impl Clone for HttpErrorKind

fn clone(&self) -> HttpErrorKind

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for HttpErrorKind

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

Formats the value using the given formatter.

impl Eq for HttpErrorKind

impl Hash for HttpErrorKind

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for HttpErrorKind

fn eq(&self, other: &HttpErrorKind) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for HttpErrorKind