Struct ErrorWithBody 

pub struct ErrorWithBody { /* private fields */ }

A reqwest::Error that may also contain the response body.

Created from a response using the ResponseExt::error_for_status_with_body method. Can also be created from a reqwest::Error.

Example

use reqwest_extra::{ErrorWithBody, ResponseExt};

async fn fetch_string(url: &str) -> Result<String, ErrorWithBody> {
    let response = reqwest::get(url)
        .await?
        .error_for_status_with_body()
        .await?
        .text()
        .await?;
    Ok(response)
}

    let err = fetch_string("https://api.github.com/user").await.unwrap_err();
    println!("{err}");

Output (line-wrapped for readability):

HTTP status client error (403 Forbidden) for url (https://api.github.com/user),
body: b"\r\nRequest forbidden by administrative rules.
Please make sure your request has a User-Agent header
(https://docs.github.com/en/rest/overview/resources-in-the-rest-api#user-agent-required).
Check https://developer.github.com for other possible causes.\r\n"

Implementations

impl ErrorWithBody

pub fn inner(&self) -> &Error

Get a reference to the inner reqwest::Error.

pub fn inner_mut(&mut self) -> &mut Error

Get a mutable reference to the inner reqwest::Error.

pub fn into_inner(self) -> Error

Consume the ErrorWithBody, returning the inner reqwest::Error.

pub fn body(&self) -> Option<&Result<Bytes, Error>>

Get a reference to the response body, if available.

pub fn body_mut(&mut self) -> Option<&mut Result<Bytes, Error>>

Get a mutable reference to the response body, if available.

pub fn into_body(self) -> Option<Result<Bytes, Error>>

Consume the ErrorWithBody, returning the response body, if available.

pub fn into_parts(self) -> (Error, Option<Result<Bytes, Error>>)

Consume the ErrorWithBody, returning both the inner reqwest::Error and the response body, if available.

pub fn with_url(self, url: Url) -> Self

Add a url related to this error (overwriting any existing).

pub fn without_url(self) -> Self

Strip the related url from this error (if, for example, it contains sensitive information).

Trait Implementations

impl Debug for ErrorWithBody

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

Formats the value using the given formatter.

impl Display for ErrorWithBody

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

Formats the value using the given formatter.

impl Error for ErrorWithBody

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

Returns 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<Error> for ErrorWithBody

fn from(err: Error) -> Self

Converts to this type from the input type.