Struct TestResponse 

pub struct TestResponse { /* private fields */ }

Captured in-memory HTTP response.

TestResponse owns the status, headers, and collected body returned by crate::TestRequest::send. Assertion helpers panic with ordinary test assertion failures, while try_json, text, and header_str expose fallible parsing.

use http::StatusCode;
use serde_json::json;

let response = app.get("/health").send().await;
response.assert_status(StatusCode::OK);
assert_eq!(response.header_str("content-type")?.unwrap(), "application/json");
response.assert_json(json!({ "ok": true }));

Implementations

impl TestResponse

pub fn status(&self) -> StatusCode

Returns the response status code.

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

Returns the raw response body bytes.

pub fn headers(&self) -> &HeaderMap

Returns the response headers.

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

Returns a response header by name.

pub fn header_str( &self, name: impl AsRef<str>, ) -> Result<Option<&str>, ToStrError>

Returns a response header as a UTF-8 string when present.

pub fn assert_status(&self, expected: StatusCode)

Asserts the response status code.

pub fn assert_header(&self, name: impl AsRef<str>, expected: &str)

Asserts a response header as a UTF-8 string.

pub fn json<T>(&self) -> T

where T: DeserializeOwned,

Decodes the response body as JSON.

Panics when the body is not valid JSON for T. Use Self::try_json when asserting malformed responses.

pub fn try_json<T>(&self) -> Result<T>

where T: DeserializeOwned,

Tries to decode the response body as JSON.

pub fn text(&self) -> Result<&str, Utf8Error>

Returns the response body as UTF-8 text.

pub fn assert_text(self, expected: &str)

Asserts the response body as UTF-8 text.

This consumes the response so tests cannot accidentally assert against a body after moving it into another helper.

pub fn assert_json(self, expected: Value)

Asserts the response body as JSON.

This consumes the response and compares against a serde_json::Value.