Enum FetchError 

pub enum FetchError {
    Request(Error),
    Url(ParseError),
    Json(Error),
    InvalidProxy(String),
    SessionNotActive,
    SessionAlreadyActive,
    MaxRetriesExceeded {
        attempts: u32,
        last_error: Box<FetchError>,
    },
    NoRequest,
    Other(String),
}

Errors that can occur during HTTP fetching operations.

This is the single error type for the entire crate. It wraps errors from underlying libraries (wreq, url, serde_json) and adds scrapling-specific variants for proxy, session, and retry failures.

Variants

Request(Error)

An error from the underlying wreq HTTP client, such as a connection failure, timeout, or TLS handshake error. Inspect the inner wreq::Error for details.

Url(ParseError)

The URL string could not be parsed. This typically happens when a relative URL is passed where an absolute one is expected, or when the scheme is missing.

Json(Error)

A JSON serialization or deserialization error. This occurs when a RequestConfig::json body cannot be serialized, or when response JSON is malformed.

InvalidProxy(String)

The proxy configuration is invalid. The contained string describes what went wrong – for example, a duplicate proxy in a rotator or a malformed proxy URL.

SessionNotActive

A request was attempted on a FetcherSession that has not been opened yet. Call open() first.

SessionAlreadyActive

open() was called on a session that is already active. Close the existing session before opening a new one.

MaxRetriesExceeded

All retry attempts have been exhausted without a successful response. The last_error field contains the error from the final attempt so you can diagnose the root cause.

Fields

attempts: u32

The total number of attempts made.

last_error: Box<FetchError>

The error from the final attempt.

NoRequest

The response has no associated request metadata. This can happen when a Response is constructed manually rather than by the fetcher.

Other(String)

A catch-all error with a descriptive message for situations not covered by the other variants (e.g., an invalid HTTP method string).

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.

impl From<Error> for FetchError

fn from(e: Error) -> Self

Converts to this type from the input type.

impl From<Error> for FetchError

fn from(e: Error) -> Self

Converts to this type from the input type.

impl From<ParseError> for FetchError

fn from(e: ParseError) -> Self

Converts to this type from the input type.