ktor-server-test-host/io.ktor.server.testing/TestApplicationEngine

TestApplicationEngine

class TestApplicationEngine(environment: <ERROR CLASS>, configure: TestApplicationEngine.Configuration.() -> Unit) : CoroutineScope

A test engine that provides a way to simulate application calls to the existing application module(s) without actual HTTP connection.

Constructors

fun TestApplicationEngine(environment: <ERROR CLASS> = createTestEnvironment(), configure: TestApplicationEngine.Configuration.() -> Unit = {})

Types

Configuration

class Configuration

An engine configuration for a test application.

Functions

createCall

fun createCall(readResponse: Boolean = false, closeRequest: Boolean = true, context: CoroutineContext = Dispatchers.IOBridge, setup: TestApplicationRequest.() -> Unit): TestApplicationCall

Creates an instance of a test call but doesn't start request processing.

handleRequest

fun handleRequest(closeRequest: Boolean = true, setup: TestApplicationRequest.() -> Unit): TestApplicationCall

Makes a test request.

handleWebSocket

fun handleWebSocket(uri: String, setup: TestApplicationRequest.() -> Unit): TestApplicationCall

Makes a test request that sets up a websocket session and waits for completion.

hookRequests

fun hookRequests(processRequest: TestApplicationRequest.(setup: TestApplicationRequest.() -> Unit) -> Unit, processResponse: TestApplicationCall.() -> Unit, block: () -> Unit)

Installs a hook for test requests.

resolvedConnectors

open suspend fun resolvedConnectors(): List<<ERROR CLASS>>

start

open fun start(wait: Boolean): <ERROR CLASS>

stop

open fun stop(gracePeriodMillis: Long, timeoutMillis: Long)

Properties

callInterceptor

var callInterceptor: <ERROR CLASS><Unit, <ERROR CLASS>>

client

val client: <ERROR CLASS>

coroutineContext

open override val coroutineContext: CoroutineContext

engine

val engine: <ERROR CLASS>

An instance of a client engine to be used in client.

Extensions

cookiesSession

fun TestApplicationEngine.cookiesSession(callback: () -> Unit)

Keeps cookies between requests inside the callback.

handleRequest

fun TestApplicationEngine.handleRequest(method: <ERROR CLASS>, uri: String, setup: TestApplicationRequest.() -> Unit = {}): TestApplicationCall

Makes a test request.

handleWebSocketConversation

fun TestApplicationEngine.handleWebSocketConversation(uri: String, setup: TestApplicationRequest.() -> Unit = {}, awaitCallback: Boolean = true, callback: suspend TestApplicationCall.(incoming: ReceiveChannel<Frame>, outgoing: SendChannel<Frame>) -> Unit): TestApplicationCall

Makes a test request that sets up a WebSocket session and invokes the callback function that handles conversation with the server