Struct Response 

pub struct Response { /* private fields */ }

HTTP response wrapper providing convenience methods for body consumption.

Implementations

impl Response

pub fn status(&self) -> StatusCode

HTTP status code.

pub fn headers(&self) -> &HeaderMap

Response headers.

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

Return the first value of the named response header as a UTF-8 string, or None if the header is absent or its value is not valid UTF-8.

Example

use oxihttp_client::Client;

let client = Client::builder().build()?;
let resp = client.get("http://example.com/new-resource")?.send().await?;
if let Some(location) = resp.header("location") {
    println!("redirected to: {location}");
}
if let Some(nonce) = resp.header("replay-nonce") {
    println!("ACME nonce: {nonce}");
}

pub fn version(&self) -> Version

HTTP version used for this response.

pub fn content_length(&self) -> Option<u64>

Content-Length header as u64 if present and valid.

pub async fn body_bytes(self) -> Result<Bytes, OxiHttpError>

Consume the body and return raw bytes, auto-decompressing if enabled.

pub async fn body_text(self) -> Result<String, OxiHttpError>

Consume the body and return it as a UTF-8 string.

pub async fn body_json<T: DeserializeOwned>(self) -> Result<T, OxiHttpError>

Consume the body and deserialize it as JSON.

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

Return an error if the response status is a client (4xx) or server (5xx) error.

Returns Ok(self) for success and redirect status codes.

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

Returns the Content-Type header value as a string, if present.

pub fn cookies(&self) -> Vec<Cookie>

Parse all Set-Cookie response headers using oxihttp_core::Cookie::parse_set_cookie.

Returns an empty Vec when there are no Set-Cookie headers or none parse successfully.

pub fn body_stream(self) -> BodyStream

Consume the response and return the body as an async stream of chunks.

Trait Implementations

impl Debug for Response

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

Formats the value using the given formatter.