Enum ureq::Error [−][src]
An error that may occur when processing a Request.
This can represent connection-level errors (e.g. connection refused),
protocol-level errors (malformed response), or status code errors
(e.g. 404 Not Found). Status code errors are represented by the
Status enum variant, while connection-level and
protocol-level errors are represented by the Transport
enum variant. You can use a match statement to extract a Response
from a Status
error. For instance, you may want to read the full
body of a response because you expect it to contain a useful error
message. Or you may want to handle certain error code responses
differently.
Examples
Example of matching out all unexpected server status codes.
use ureq::Error; match ureq::get("http://mypage.example.com/").call() { Ok(response) => { /* it worked */}, Err(Error::Status(code, response)) => { /* the server returned an unexpected status code (such as 400, 500 etc) */ } Err(_) => { /* some kind of io/transport error */ } }
An example of a function that handles HTTP 429 and 500 errors differently than other errors. They get retried after a suitable delay, up to 4 times.
use std::{result::Result, time::Duration, thread}; use ureq::{Response, Error, Error::Status}; fn get_response(url: &str) -> Result<Response, Error> { for _ in 1..4 { match ureq::get(url).call() { Err(Status(503, r)) | Err(Status(429, r)) => { let retry: Option<u64> = r.header("retry-after") .and_then(|h| h.parse().ok()); let retry = retry.unwrap_or(5); eprintln!("{} for {}, retry in {}", r.status(), r.get_url(), retry); thread::sleep(Duration::from_secs(retry)); } result => return result, }; } // Ran out of retries; try one last time and return whatever result we get. ureq::get(url).call() }
If you’d like to treat all status code errors as normal, successful responses, you can use OrAnyStatus::or_any_status like this:
use ureq::Error::Status; use ureq::OrAnyStatus; let resp = ureq::get("http://example.com/") .call() .or_any_status()?;
Variants
A response was successfully received but had status code >= 400. Values are (status_code, Response).
Transport(Transport)
There was an error making the request or receiving the response.
Implementations
Trait Implementations
impl From<ParseError> for Error
[src]
impl From<ParseError> for Error
[src]fn from(err: ParseError) -> Self
[src]
Auto Trait Implementations
impl !RefUnwindSafe for Error
impl !RefUnwindSafe for Error
impl !UnwindSafe for Error
impl !UnwindSafe for Error