Enum FetchError 

#[non_exhaustive]
pub enum FetchError {
    ConnectionFailed {
        detail: String,
        source: Option<Error>,
    },
    HeaderTooLarge {
        detail: String,
    },
    BodyTooLarge,
    Timeout,
    Cancelled,
    Internal(String),
}

Typed error returned by the pure-Rust fetch_request API.

Header-oversize detection lives above this layer in [crate::ffi::fetch], which compares the assembled response head byte-count against the endpoint’s max_header_size. That check is deterministic and does not depend on hyper’s error wording, so this enum no longer disambiguates header parse failures from other transport errors — they all surface as ConnectionFailed.

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.

ConnectionFailed

Connection setup, hyper handshake, or send-request transport failure. Wraps the underlying hyper::Error when one is available so callers can downcast instead of substring-matching.

Fields

detail: String

source: Option<Error>

HeaderTooLarge

Response head exceeded the endpoint’s max_header_size budget. Produced only by [crate::ffi::fetch]’s post-receive byte-count check; fetch_request itself never emits this variant.

Fields

detail: String

BodyTooLarge

Response body exceeded the configured byte limit. Surfaced by the FFI wrapper after the body is drained.

Timeout

cfg.timeout elapsed before the response head arrived.

Cancelled

Caller dropped the future or signalled cancellation via the FFI fetch token.

Internal(String)

Bug or unexpected internal failure (request build, body wrap, …).

Trait Implementations

impl Debug for FetchError

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

Formats the value using the given formatter.

impl Display for FetchError

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

Formats the value using the given formatter.

impl Error for FetchError

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.