Struct isahc::error::Error

pub struct Error(_);

An error encountered while sending an HTTP request or receiving an HTTP response.

This type is intentionally opaque, as sending an HTTP request involves many different moving parts, some of which can be platform or device-dependent. It is recommended that you use the kind method to get a more generalized classification of error types that this error could be if you need to handle different sorts of errors in different ways.

If you need to get more specific details about the reason for the error, you can use the source method. We do not provide any stability guarantees about what error sources are returned.

Implementations

impl Error

pub fn kind(&self) -> &ErrorKind

Get the kind of error this represents.

The kind returned may not be matchable against any known documented if the reason for the error is unknown. Unknown errors may be an indication of a bug, or an error condition that we do not recognize appropriately. Either way, please report such occurrences to us!

pub fn is_client(&self) -> bool

Returns true if this error was likely caused by the client.

Usually indicates that the client was misconfigured or used to send invalid data to the server. Requests that return these sorts of errors probably should not be retried without first fixing the request parameters.

pub fn is_network(&self) -> bool

Returns true if this is an error likely related to network failures.

pub fn is_server(&self) -> bool

Returns true if this error was likely the fault of the server.

pub fn is_tls(&self) -> bool

Returns true if this error is related to SSL/TLS.

Trait Implementations

impl Clone for Error

pub fn clone(&self) -> Error

Returns a copy of the value.

pub fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

pub fn source(&self) -> Option<&(dyn StdError + 'static)>

The lower-level source of this error, if any.

pub fn backtrace(&self) -> Option<&Backtrace>

🔬 This is a nightly-only experimental API. (backtrace)

Returns a stack backtrace, if available, of where this error occurred.

pub fn description(&self) -> &str

👎 Deprecated since 1.42.0:

use the Display impl or to_string()

pub fn cause(&self) -> Option<&dyn Error>

👎 Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

impl From<Error> for Error

pub fn from(error: Error) -> Self

Performs the conversion.

impl From<Error> for Error

pub fn from(error: Error) -> Error

Performs the conversion.

impl From<ErrorKind> for Error

pub fn from(kind: ErrorKind) -> Self

Performs the conversion.

impl PartialEq<ErrorKind> for Error

pub fn eq(&self, kind: &ErrorKind) -> bool

This method tests for self and other values to be equal, and is used by ==.

#[must_use]pub fn ne(&self, other: &Rhs) -> bool

This method tests for !=.