Struct TestResponse 

pub struct TestResponse { /* private fields */ }

Response from a test request with assertion helpers.

TestResponse wraps a Response and provides convenient methods for accessing response data and making assertions in tests.

Example

let response = client.get("/api/user").send();

assert_eq!(response.status(), StatusCode::OK);
assert!(response.header("content-type").contains("application/json"));

let user: User = response.json().unwrap();
assert_eq!(user.name, "Alice");

Implementations

impl TestResponse

pub fn request_id(&self) -> u64

Returns the request ID for tracing.

pub fn status(&self) -> StatusCode

Returns the HTTP status code.

pub fn status_code(&self) -> u16

Returns the status code as a u16.

pub fn is_success(&self) -> bool

Checks if the status is successful (2xx).

pub fn is_redirect(&self) -> bool

Checks if the status is a redirect (3xx).

pub fn is_client_error(&self) -> bool

Checks if the status is a client error (4xx).

pub fn is_server_error(&self) -> bool

Checks if the status is a server error (5xx).

pub fn headers(&self) -> &[(String, Vec<u8>)]

Returns all headers.

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

Returns a header value by name (case-insensitive).

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

Returns a header value as a string (case-insensitive).

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

Returns the Content-Type header value.

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

Returns the body as raw bytes.

pub fn text(&self) -> &str

Returns the body as a UTF-8 string.

Panics

Panics if the body is not valid UTF-8.

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

Tries to return the body as a UTF-8 string.

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

Parses the body as JSON.

Errors

Returns an error if the body cannot be parsed as the target type.

Example

#[derive(Deserialize)]
struct User { name: String }

let user: User = response.json().unwrap();

pub fn content_length(&self) -> usize

Returns the body length.

pub fn into_inner(self) -> Response

Returns the underlying response.

pub fn assert_status(&self, expected: StatusCode) -> &Self

Asserts that the status code equals the expected value.

Panics

Panics with a descriptive message if the assertion fails.

pub fn assert_status_code(&self, expected: u16) -> &Self

Asserts that the status code equals the expected u16 value.

Panics

Panics with a descriptive message if the assertion fails.

pub fn assert_success(&self) -> &Self

Asserts that the response is successful (2xx).

Panics

Panics if the status is not in the 2xx range.

pub fn assert_header(&self, name: &str, expected: &str) -> &Self

Asserts that a header exists with the given value.

Panics

Panics if the header doesn’t exist or doesn’t match.

pub fn assert_text(&self, expected: &str) -> &Self

Asserts that the body equals the expected string.

Panics

Panics if the body doesn’t match.

pub fn assert_text_contains(&self, expected: &str) -> &Self

Asserts that the body contains the expected substring.

Panics

Panics if the body doesn’t contain the substring.

pub fn assert_json<T>(&self, expected: &T) -> &Self

where T: DeserializeOwned + Serialize + PartialEq + Debug,

Asserts that the JSON body equals the expected value.

Panics

Panics if parsing fails or the value doesn’t match.

pub fn assert_json_contains(&self, expected: &Value) -> &Self

Asserts that the JSON body contains all fields from the expected value.

This performs partial matching: the actual response may contain additional fields not present in expected, but all fields in expected must be present in the actual response with matching values.

Panics

Panics if parsing fails or partial matching fails.

Example

// Response body: {"id": 1, "name": "Alice", "email": "alice@example.com"}
// This passes because all expected fields match:
response.assert_json_contains(&json!({"name": "Alice"}));

pub fn assert_header_exists(&self, name: &str) -> &Self

Asserts that a header exists (regardless of value).

Panics

Panics if the header doesn’t exist.

pub fn assert_header_missing(&self, name: &str) -> &Self

Asserts that a header does not exist.

Panics

Panics if the header exists.

pub fn assert_content_type_contains(&self, expected: &str) -> &Self

Asserts that the Content-Type header contains the expected value.

This is a convenience method that checks if the Content-Type header contains the given string (useful for checking media types ignoring charset).

Panics

Panics if the Content-Type header doesn’t exist or doesn’t contain the expected value.

Trait Implementations

impl Debug for TestResponse

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

Formats the value using the given formatter.