Struct TestResponse 

pub struct TestResponse { /* private fields */ }

One response, with its body already read.

The body is collected on construction so every assertion can be &self and chain. A streaming body can only be read once, and a harness that made you think about that would be a harness that made you think about the wrong thing.

Implementations

impl TestResponse

pub async fn of(response: Response) -> Self

Read response into an assertable one.

pub fn status(&self) -> StatusCode

The status.

pub fn text(&self) -> &str

The body, as text.

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

A header’s value.

pub fn json(&self) -> Value

The body as JSON.

Panics

If it will not parse — printing what arrived, because that is nearly always an error response the test did not expect.

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

The body deserialised into your own type.

Panics

If it will not deserialise, printing the body.

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

Panic unless the status is exactly this.

Panics

If it is not — printing the body, which is where the reason is.

pub fn assert_ok(&self) -> &Self

Panic unless the status is 2xx.

Panics

If it is not.

pub fn assert_created(&self) -> &Self

Panic unless the status is 201.

Panics

If it is not.

pub fn assert_no_content(&self) -> &Self

Panic unless the status is 204.

Panics

If it is not.

pub fn assert_not_found(&self) -> &Self

Panic unless the status is 404.

Panics

If it is not.

pub fn assert_unauthorized(&self) -> &Self

Panic unless the status is 401.

Panics

If it is not.

pub fn assert_forbidden(&self) -> &Self

Panic unless the status is 403.

Panics

If it is not.

pub fn assert_invalid(&self) -> &Self

Panic unless the status is 422 — a failed request contract.

Panics

If it is not.

pub fn assert_json_path(&self, path: &str, expected: impl Into<Value>) -> &Self

Panic unless the JSON at path equals expected.

path is dotted, and an index is a segment: data.0.title.

Panics

If the path is absent or holds something else.

pub fn assert_json_missing(&self, path: &str) -> &Self

Panic unless there is nothing at path.

For asserting a field was not serialised — a password hash, an internal id.

Panics

If something is there.

pub fn assert_contains(&self, text: &str) -> &Self

Panic unless the body contains text.

Panics

If it does not.

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

Panic unless the header is present with this value.

Panics

If it is absent or different.

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

Panic unless the header is absent.

Panics

If it is present.