Struct ureq::Transport

pub struct Transport { /* private fields */ }

Error that is not a status code error. For instance, DNS name not found, connection refused, or malformed response.

• Transport::kind() provides a classification (same as for Error::kind).
• Transport::message() might vary for the same classification to give more context.
• Transport::source() holds the underlying error with even more details.

use ureq::ErrorKind;
use std::error::Error;
use url::ParseError;

let result = ureq::get("broken/url").call();
let error = result.unwrap_err().into_transport().unwrap();

// the display trait is a combo of the underlying classifications
assert_eq!(error.to_string(),
    "Bad URL: failed to parse URL: RelativeUrlWithoutBase: relative URL without a base");

// classification
assert_eq!(error.kind(), ErrorKind::InvalidUrl);
assert_eq!(error.kind().to_string(), "Bad URL");

// higher level message
assert_eq!(error.message(), Some("failed to parse URL: RelativeUrlWithoutBase"));

// boxed underlying error
let source = error.source().unwrap();
// downcast to original error
let downcast: &ParseError = source.downcast_ref().unwrap();

assert_eq!(downcast.to_string(), "relative URL without a base");

Implementations

impl Transport

pub fn kind(&self) -> ErrorKind

The type of error that happened while processing the request.

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

Higher level error details, if there are any.

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

The url that failed. This can be interesting in cases of redirect where the original url worked, but a later redirected to url fails.

Trait Implementations

impl Debug for Transport

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

Formats the value using the given formatter.

impl Display for Transport

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

Formats the value using the given formatter.

impl Error for Transport

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

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<Transport> for Error

fn from(err: Transport) -> Error

Converts to this type from the input type.