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 backtrace(&self) -> Option<&Backtrace>

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

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

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

impl From<Transport> for Error

fn from(err: Transport) -> Error

Converts to this type from the input type.