Enum Error 

#[non_exhaustive]
pub enum Error {
    InvalidUrl {
        url: String,
        reason: String,
    },
    Timeout {
        url: String,
        timeout: Duration,
    },
    AddressNotAllowed {
        host: String,
    },
    Engine {
        url: Option<String>,
        source: Box<dyn StdError + Send + Sync + 'static>,
    },
    JavaScript {
        url: Option<String>,
        source: Box<dyn StdError + Send + Sync + 'static>,
    },
    Screenshot {
        url: Option<String>,
        source: Box<dyn StdError + Send + Sync + 'static>,
    },
    Extract(ExtractError),
    Cookies {
        path: String,
        reason: String,
    },
    Schema(SchemaError),
    Io(Error),
    InvalidGlob(Error),
    InvalidHeader(String),
}

Errors from servo-fetch operations.

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.

InvalidUrl

The URL is malformed or uses a disallowed scheme.

Fields

url: String

The URL that failed validation.

reason: String

Why the URL is invalid.

Timeout

The page did not finish loading within the configured timeout.

Fields

url: String

The URL that timed out.

timeout: Duration

The timeout that was exceeded.

AddressNotAllowed

The URL resolves to a private or reserved address (SSRF protection).

Fields

host: String

The blocked host.

Engine

The Servo engine is unavailable or crashed.

Fields

url: Option<String>

URL being processed, if known.

source: Box<dyn StdError + Send + Sync + 'static>

Source error.

JavaScript

JavaScript evaluation failed.

Fields

url: Option<String>

URL being processed, if known.

source: Box<dyn StdError + Send + Sync + 'static>

Source error.

Screenshot

Screenshot capture failed.

Fields

url: Option<String>

URL being captured, if known.

source: Box<dyn StdError + Send + Sync + 'static>

Source error.

Extract(ExtractError)

Content extraction failed.

Cookies

Failed to load or parse a cookies file.

Fields

path: String

The cookies file path.

reason: String

Why loading failed.

Schema(SchemaError)

Schema-based structured extraction failed.

Io(Error)

An I/O error occurred.

InvalidGlob(Error)

A glob pattern is invalid.

InvalidHeader(String)

A custom request header is malformed or not permitted.

Implementations

impl Error

pub fn is_timeout(&self) -> bool

Returns true if this is a timeout error.

pub fn is_network(&self) -> bool

Returns true if this is a network-related error (timeout or address-policy rejection).

pub fn url(&self) -> Option<&str>

Returns the URL associated with this error, if any.

pub fn host(&self) -> Option<&str>

Returns the host that was rejected, if this is Error::AddressNotAllowed.

Trait Implementations

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

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 Error

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<ExtractError> for Error

fn from(source: ExtractError) -> Self

Converts to this type from the input type.

impl From<SchemaError> for Error

fn from(source: SchemaError) -> Self

Converts to this type from the input type.