TestClient class

A client for testing HTTP endpoints with different transport modes.

This is the main entry point for testing HTTP-based applications. It provides methods for sending HTTP requests and handling responses with a fluent API. The client can operate in different transport modes, allowing tests to be run either in-memory (for speed) or using real HTTP servers (for integration testing).

Basic Usage

// Create a client with your request handler
final client = TestClient(yourRequestHandler);

// Send a GET request
final response = await client.get('/users');

// Make assertions on the response
response
    .assertStatus(200)
    .assertJsonPath('users.0.name', 'Alice');

Transport Modes

The client supports two transport modes:

• TransportMode.inMemory: Requests are handled in memory without network I/O
• TransportMode.ephemeralServer: A real HTTP server is started for testing

Multipart Requests

For file uploads and form submissions, use the multipart method:

final response = await client.multipart('/upload', (builder) {
  builder.addField('description', 'Test file');
  builder.addFileFromBytes(
    name: 'file',
    bytes: imageBytes,
    filename: 'test.jpg',
    contentType: MediaType('image', 'jpeg'),
  );
});