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

Package io.ktor.server.testing

Types

abstract class EngineTestBase<TEngine : ApplicationEngine, TConfiguration : ApplicationEngine.Configuration>(applicationEngineFactory: ApplicationEngineFactory<TEngine, TConfiguration>) : CoroutineScope

HighLoadHttpGenerator

class HighLoadHttpGenerator(host: String, port: Int, numberOfConnections: Int, queueSize: Int, highPressure: Boolean, builder: RequestResponseBuilder.() -> Unit)

This HTTP generator produces huge amount of requests however it doesn't validate responses and doesn't measure any time characteristics.

object It

it function receiver object

object On

on function receiver object

StressSuiteRunner

class StressSuiteRunner(klass: Class<*>) : Runner, Filterable, Sortable

TestApplicationCall

class TestApplicationCall(application: Application, readResponse: Boolean, closeRequest: Boolean, coroutineContext: CoroutineContext) : BaseApplicationCall, CoroutineScope

Represents a test application call that is used in withTestApplication and handleRequest

TestApplicationEngine

class TestApplicationEngine(environment: ApplicationEngineEnvironment, configure: TestApplicationEngine.Configuration.() -> Unit) : BaseApplicationEngine, CoroutineScope

ktor test engine that provides way to simulate application calls to existing application module(s) without actual HTTP connection

TestApplicationRequest

class TestApplicationRequest(call: TestApplicationCall, closeRequest: Boolean, method: HttpMethod, uri: String, version: String) : BaseApplicationRequest, CoroutineScope

Represents a test application request

TestApplicationResponse

class TestApplicationResponse(call: TestApplicationCall, readResponse: Boolean) : BaseApplicationResponse, CoroutineScope

Represents test call response received from server

TestEngine

object TestEngine : ApplicationEngineFactory<TestApplicationEngine, TestApplicationEngine.Configuration>

An ApplicationEngineFactory providing a CIO-based ApplicationEngine

Functions

awaitWebSocket

fun TestApplicationResponse.awaitWebSocket(duration: Duration)

Wait for websocket session completion

contentType

fun TestApplicationResponse.contentType(): ContentType

Return parsed content type from the test response

cookiesSession

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

Keep cookies between requests inside the callback.

createTestEnvironment

fun createTestEnvironment(configure: ApplicationEngineEnvironmentBuilder.() -> Unit = {}): ApplicationEngineEnvironment

Creates test application engine environment

handleRequest

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

Make a test request

inline fun On.it(description: String, body: It.() -> Unit)

DSL function for test test case assertions

fun on(comment: String, body: On.() -> Unit)

DSL for creating a test case

setBody

fun TestApplicationRequest.setBody(value: ByteArray)

Set HTTP request body bytes

fun TestApplicationRequest.setBody(value: String)

Set HTTP request body text content

fun TestApplicationRequest.setBody(boundary: String, parts: List<PartData>)

Set multipart HTTP request body

withApplication

fun <R> withApplication(environment: ApplicationEngineEnvironment = createTestEnvironment(), configure: TestApplicationEngine.Configuration.() -> Unit = {}, test: TestApplicationEngine.() -> R): R

Start test application engine, pass it to test function and stop it

withTestApplication

fun <R> withTestApplication(test: TestApplicationEngine.() -> R): R

fun <R> withTestApplication(moduleFunction: Application.() -> Unit, test: TestApplicationEngine.() -> R): R

fun <R> withTestApplication(moduleFunction: Application.() -> Unit, configure: TestApplicationEngine.Configuration.() -> Unit = {}, test: TestApplicationEngine.() -> R): R

Start test application engine, pass it to test function and stop it