Struct HttpResponse 

pub struct HttpResponse {
    pub meta: HttpResponseMeta,
    /* private fields */
}

Unified HTTP response with lazily consumed body.

Fields

meta: HttpResponseMeta

Response metadata (status, headers, final URL, request method).

Implementations

impl HttpResponse

pub fn new( status: StatusCode, headers: HeaderMap, body: Bytes, url: Url, method: Method, ) -> Self

Creates a buffered response.

pub fn meta(&self) -> &HttpResponseMeta

Returns shared response metadata.

pub fn status(&self) -> StatusCode

Returns response status code.

pub fn headers(&self) -> &HeaderMap

Returns response headers.

pub fn url(&self) -> &Url

Returns final response URL.

pub fn request_url(&self) -> &Url

Returns request URL used in response read context.

pub fn is_success(&self) -> bool

Returns whether status is success.

pub fn retry_after_hint(&self) -> Option<Duration>

Returns parsed Retry-After hint when status and headers provide one.

pub async fn bytes(&mut self) -> HttpResult<Bytes>

Returns full body bytes, consuming backend stream lazily on first call.

pub fn stream(&mut self) -> HttpResult<HttpByteStream>

Returns body as stream; if already buffered, returns stream backed by cached bytes.

pub async fn text(&mut self) -> HttpResult<String>

Interprets response body as UTF-8 text.

pub async fn json<T>(&mut self) -> HttpResult<T>

where T: DeserializeOwned,

Deserializes response body as JSON.

pub fn sse_max_line_bytes(self, max_line_bytes: usize) -> Self

Overrides the maximum allowed size (in bytes) for one SSE line on this response.

Values below 1 are clamped to 1. Returns self so callers can chain configuration before consuming the body with Self::sse_events or Self::sse_chunks (together with Self::sse_json_mode, Self::sse_done_marker_policy, etc.).

pub fn sse_max_frame_bytes(self, max_frame_bytes: usize) -> Self

Overrides the maximum allowed size (in bytes) for one SSE frame on this response.

Values below 1 are clamped to 1. Returns self for chained configuration.

pub fn sse_json_mode(self, mode: SseJsonMode) -> Self

Overrides the JSON decoding mode used by Self::sse_chunks on this response.

pub fn sse_done_marker_policy(self, policy: DoneMarkerPolicy) -> Self

Overrides how Self::sse_chunks detects end-of-stream from trimmed data: payloads.

pub fn sse_events(self) -> SseEventStream

Decodes body stream as SSE events using this response’s SSE line/frame byte limits (from client defaults unless overridden via Self::sse_max_line_bytes / Self::sse_max_frame_bytes).

pub fn sse_chunks<T>(self) -> SseChunkStream<T>

where T: DeserializeOwned + Send + 'static,

Decodes SSE data: lines as JSON chunks using this response’s SSE JSON mode, done-marker policy, and line/frame limits (see Self::sse_json_mode, Self::sse_done_marker_policy, Self::sse_max_line_bytes, Self::sse_max_frame_bytes).

Trait Implementations

impl Debug for HttpResponse

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

Formats the value using the given formatter.