Struct isahc::error::Error [−][src]
pub struct Error(_);
Expand description
An error encountered while sending an HTTP request or receiving an HTTP response.
Note that errors are typically caused by failed I/O or protocol errors. 4xx or 5xx responses successfully received from the server are generally not considered an error case.
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
Get the kind of error this represents.
The kind returned may not be matchable against any documented variants 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!
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.
Returns true if this is an error likely related to network failures.
Network operations are inherently unreliable. Sometimes retrying the request once or twice is enough to resolve the error.
Returns true if this error is caused from exceeding a configured timeout.
A request could time out for any number of reasons, for example:
- Slow or broken network preventing the server from receiving the request or replying in a timely manner.
- The server received the request but is taking a long time to fulfill the request.
Sometimes retrying the request once or twice is enough to resolve the error.
Trait Implementations
Auto Trait Implementations
impl !RefUnwindSafe for Error
impl !UnwindSafe for Error
Blanket Implementations
Mutably borrows from an owned value. Read more
Instruments this type with the provided Span
, returning an
Instrumented
wrapper. Read more
Instruments this type with the provided Span
, returning an
Instrumented
wrapper. Read more
Attaches the provided Subscriber
to this type, returning a
WithDispatch
wrapper. Read more
Attaches the current default Subscriber
to this type, returning a
WithDispatch
wrapper. Read more