Struct gotham::test::TestResponse
source · pub struct TestResponse { /* private fields */ }
Expand description
Wrapping struct for the Response
returned by a TestClient
. Provides access to the
Response
value via the Deref
and DerefMut
traits, and also provides a function for
awaiting a completed response body.
Examples
use gotham::test::TestServer;
let test_server = TestServer::new(|| Ok(my_handler)).unwrap();
let response = test_server.client().get("http://localhost/").perform().unwrap();
assert_eq!(response.status(), StatusCode::OK);
let body = response.read_body().unwrap();
assert_eq!(&body[..], b"This is the body content.");
Implementations§
source§impl TestResponse
impl TestResponse
sourcepub fn read_body(self) -> Result<Vec<u8>>
pub fn read_body(self) -> Result<Vec<u8>>
Awaits the body of the underlying Response
, and returns it. This will cause the event
loop to execute until the Response
body has been fully read into the Vec<u8>
.
sourcepub fn read_utf8_body(self) -> Result<String>
pub fn read_utf8_body(self) -> Result<String>
Awaits the UTF-8 encoded body of the underlying Response
, and returns the String
. This
will cause the event loop to execute until the Response
body has been fully read and the
String
created.
Methods from Deref<Target = Response<Body>>§
sourcepub fn status(&self) -> StatusCode
pub fn status(&self) -> StatusCode
Returns the StatusCode
.
Examples
let response: Response<()> = Response::default();
assert_eq!(response.status(), StatusCode::OK);
sourcepub fn status_mut(&mut self) -> &mut StatusCode
pub fn status_mut(&mut self) -> &mut StatusCode
Returns a mutable reference to the associated StatusCode
.
Examples
let mut response: Response<()> = Response::default();
*response.status_mut() = StatusCode::CREATED;
assert_eq!(response.status(), StatusCode::CREATED);
sourcepub fn version(&self) -> Version
pub fn version(&self) -> Version
Returns a reference to the associated version.
Examples
let response: Response<()> = Response::default();
assert_eq!(response.version(), Version::HTTP_11);
sourcepub fn version_mut(&mut self) -> &mut Version
pub fn version_mut(&mut self) -> &mut Version
Returns a mutable reference to the associated version.
Examples
let mut response: Response<()> = Response::default();
*response.version_mut() = Version::HTTP_2;
assert_eq!(response.version(), Version::HTTP_2);
sourcepub fn headers(&self) -> &HeaderMap<HeaderValue>
pub fn headers(&self) -> &HeaderMap<HeaderValue>
Returns a reference to the associated header field map.
Examples
let response: Response<()> = Response::default();
assert!(response.headers().is_empty());
sourcepub fn headers_mut(&mut self) -> &mut HeaderMap<HeaderValue>
pub fn headers_mut(&mut self) -> &mut HeaderMap<HeaderValue>
Returns a mutable reference to the associated header field map.
Examples
let mut response: Response<()> = Response::default();
response.headers_mut().insert(HOST, HeaderValue::from_static("world"));
assert!(!response.headers().is_empty());
sourcepub fn extensions(&self) -> &Extensions
pub fn extensions(&self) -> &Extensions
Returns a reference to the associated extensions.
Examples
let response: Response<()> = Response::default();
assert!(response.extensions().get::<i32>().is_none());
sourcepub fn extensions_mut(&mut self) -> &mut Extensions
pub fn extensions_mut(&mut self) -> &mut Extensions
Returns a mutable reference to the associated extensions.
Examples
let mut response: Response<()> = Response::default();
response.extensions_mut().insert("hello");
assert_eq!(response.extensions().get(), Some(&"hello"));