Struct actix_web::test::TestServer

pub struct TestServer { /* fields omitted */ }

The TestServer type.

TestServer is very simple test server that simplify process of writing integration tests cases for actix web applications.

Examples

use actix_web::test::TestServer;

let mut srv = TestServer::new(|app| app.handler(my_handler));

let req = srv.get().finish().unwrap();
let response = srv.execute(req.send()).unwrap();
assert!(response.status().is_success());

Methods

impl TestServer

fn new<F>(config: F) -> Self where
    F: Sync + Send + 'static + Fn(&mut TestApp<()>), 

Start new test server

This method accepts configuration method. You can add middlewares or set handlers for test application.

fn with_factory<F, U, H>(factory: F) -> Self where
    F: Fn() -> U + Sync + Send + 'static,
    U: IntoIterator<Item = H> + 'static,
    H: IntoHttpHandler + 'static, 

Start new test server with application factory

fn with_state<S, FS, F>(state: FS, config: F) -> Self where
    S: 'static,
    FS: Sync + Send + 'static + Fn() -> S,
    F: Sync + Send + 'static + Fn(&mut TestApp<S>), 

Start new test server with custom application state

This method accepts state factory and configuration method.

fn unused_addr() -> SocketAddr

Get firat available unused address

fn addr(&self) -> SocketAddr

Construct test server url

fn url(&self, uri: &str) -> String

Construct test server url

fn execute<F, I, E>(&mut self, fut: F) -> Result<I, E> where
    F: Future<Item = I, Error = E>, 

Execute future on current core

fn ws(&mut self) -> Result<(ClientReader, ClientWriter), ClientError>

Connect to websocket server

fn get(&self) -> ClientRequestBuilder

Create GET request

fn post(&self) -> ClientRequestBuilder

Create POST request

fn head(&self) -> ClientRequestBuilder

Create HEAD request

fn client(&self, meth: Method, path: &str) -> ClientRequestBuilder

Connect to test http server

Trait Implementations

impl Drop for TestServer

fn drop(&mut self)

Executes the destructor for this type.