Enum HttpError 

#[non_exhaustive]
pub enum HttpError {
    RequestBuild(Error),
    InvalidHeaderName(InvalidHeaderName),
    InvalidHeaderValue(InvalidHeaderValue),
    Timeout(Duration),
    DeadlineExceeded(Duration),
    Transport(Box<dyn Error + Send + Sync>),
    Tls(Box<dyn Error + Send + Sync>),
    BodyTooLarge {
        limit: usize,
        actual: usize,
    },
    HttpStatus {
        status: StatusCode,
        body_preview: String,
        content_type: Option<String>,
        retry_after: Option<Duration>,
    },
    Json(Error),
    FormEncode(Error),
    Overloaded,
    ServiceClosed,
    InvalidUri {
        url: String,
        kind: InvalidUriKind,
        reason: String,
    },
    InvalidScheme {
        scheme: String,
        reason: String,
    },
}

HTTP client error types

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.

RequestBuild(Error)

Request building failed

InvalidHeaderName(InvalidHeaderName)

Invalid header name

InvalidHeaderValue(InvalidHeaderValue)

Invalid header value

Timeout(Duration)

Single request attempt timed out

DeadlineExceeded(Duration)

Total operation deadline exceeded (including all retries)

Transport(Box<dyn Error + Send + Sync>)

Transport error (network, connection, etc)

Tls(Box<dyn Error + Send + Sync>)

TLS error

BodyTooLarge

Response body exceeded size limit

Fields

limit: usize

actual: usize

HttpStatus

HTTP non-2xx status

Fields

status: StatusCode

body_preview: String

content_type: Option<String>

retry_after: Option<Duration>

Parsed Retry-After header value, if present and valid

Json(Error)

JSON parsing error

FormEncode(Error)

Form URL encoding error

Overloaded

Service overloaded (concurrency limit reached, fail-fast)

ServiceClosed

Internal service failure (buffer worker died, channel closed)

InvalidUri

Invalid URL (failed to parse)

Use the kind field for programmatic matching. The reason field contains a diagnostic message intended for logging only; do not match on its contents as the format is unstable and may change between releases.

Fields

url: String

The URL that failed to parse

kind: InvalidUriKind

Structured failure classification for programmatic matching

reason: String

Diagnostic message (unstable format, for logging only)

InvalidScheme

Invalid URL scheme for transport security configuration

Fields

scheme: String

The URL scheme that was rejected

reason: String

Reason the scheme was rejected

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

Formats the value using the given formatter.

impl Error for HttpError

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 HttpError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for HttpError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for HttpError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for HttpError

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<Error> for HttpError

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<InvalidHeaderName> for HttpError

fn from(source: InvalidHeaderName) -> Self

Converts to this type from the input type.

impl From<InvalidHeaderValue> for HttpError

fn from(source: InvalidHeaderValue) -> Self

Converts to this type from the input type.