Enum Error

#[non_exhaustive]
pub enum Error {
    StatusCode(u16),
    Http(Error),
    BadUri(String),
    Protocol(Error),
    Io(Error),
    Timeout(Timeout),
    HostNotFound,
    RedirectFailed,
    InvalidProxyUrl,
    ConnectionFailed,
    BodyExceedsLimit(u64),
    TooManyRedirects,
    RequireHttpsOnly(String),
    LargeResponseHeader(usize, usize),
    ConnectProxyFailed(String),
    TlsRequired,
}

Available on crate feature dep_ureq only.

Errors from ureq.

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.

StatusCode(u16)

When http_status_as_error() is true, 4xx and 5xx response status codes are translated to this error.

This is the default behavior.

Http(Error)

Errors arising from the http-crate.

These errors happen for things like invalid characters in header names.

BadUri(String)

Error if the URI is missing scheme or host.

Protocol(Error)

An HTTP/1.1 protocol error.

This can happen if the remote server ends incorrect HTTP data like missing version or invalid chunked transfer.

Io(Error)

Error in io such as the TCP socket.

Timeout(Timeout)

Error raised if the request hits any configured timeout.

By default no timeouts are set, which means this error can’t happen.

HostNotFound

Error when resolving a hostname fails.

RedirectFailed

A redirect failed.

This happens when ureq encounters a redirect when sending a request body such as a POST request, and receives a 307/308 response. ureq refuses to redirect the POST body and instead raises this error.

InvalidProxyUrl

Error when creating proxy settings.

ConnectionFailed

A connection failed.

BodyExceedsLimit(u64)

A send body (Such as &str) is larger than the content-length header.

TooManyRedirects

Too many redirects.

The error can be turned off by setting max_redirects_will_error() to false. When turned off, the last response will be returned instead of causing an error, even if it is a redirect.

The number of redirects is limited to 10 by default.

RequireHttpsOnly(String)

The setting https_only is true and the URI is not https.

LargeResponseHeader(usize, usize)

The response header, from status up until body, is too big.

ConnectProxyFailed(String)

Attempt to connect to a CONNECT proxy failed.

TlsRequired

The protocol requires TLS (https), but the connector did not create a TLS secured transport.

This typically indicates a fault in bespoke Connector chains.

Implementations

impl Error

pub fn into_io(self) -> Error

Convert the error into a std::io::Error.

If the error is Error::Io, we unpack the error. In othe cases we make an std::io::ErrorKind::Other.

Trait Implementations

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

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(e: Error) -> Error

Converts to this type from the input type.

impl From<Error> for Error

fn from(value: Error) -> Error

Converts to this type from the input type.

impl From<Error> for Error

fn from(value: Error) -> Error

Converts to this type from the input type.