Struct HttpResponse 

pub struct HttpResponse { /* private fields */ }

One response, with its body already read.

Implementations

impl HttpResponse

pub fn new(raw: RawResponse) -> Self

Wrap what a transport returned.

pub fn with(status: u16, body: impl Into<Vec<u8>>) -> Self

Build one directly. For a fake, and for a test.

pub fn with_header( self, name: impl Into<String>, value: impl Into<String>, ) -> Self

Add a header.

pub fn status(&self) -> u16

The status.

pub fn is_success(&self) -> bool

Whether the status is 2xx.

pub fn is_client_error(&self) -> bool

Whether the status is 4xx.

pub fn is_server_error(&self) -> bool

Whether the status is 5xx.

pub fn header(&self, name: &str) -> Option<&str>

A header’s value, however it was capitalised.

pub fn headers(&self) -> &BTreeMap<String, String>

Every header.

pub fn bytes(&self) -> &[u8]

The body, as bytes.

pub fn text(&self) -> String

The body, as text.

pub fn json<T: DeserializeOwned>(&self) -> Result<T>

The body, deserialised.

Errors

Quoting the start of the body, because a parse failure here is almost always an error page or a rate-limit notice where JSON was expected, and expected value at line 1 column 1 says nothing about which.

pub fn error_for_status(self) -> Result<Self>

Turn a 4xx or 5xx into an error.

Not automatic, and deliberately: plenty of callers want to look at a 404 rather than propagate it, and a client that made that decision for them would have them parsing the error back apart.

The message carries the status and the start of the body, which is where the other end put the reason.

Trait Implementations

impl Clone for HttpResponse

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for HttpResponse

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

Formats the value using the given formatter.