Question 1

How to set up HttpClientInterception for ASP.NET Core integration tests?

Accepted Answer

Register an HttpClientInterceptionFilter as an IHttpMessageHandlerBuilderFilter in your test startup, as shown in the sample code. This injects the interceptor into HttpClient instances from DI without altering app code, ensuring seamless interception.

Question 2

Can HttpClientInterception simulate network delays or timeouts?

Accepted Answer

No, the library focuses on stubbing responses and HTTP faults like 500 errors; it does not natively support simulating latency or timeouts. For that, you'd need to use other tools or add custom delay logic in your tests.

Question 3

HttpClientInterception vs WireMock.NET: which is better for .NET testing?

Accepted Answer

HttpClientInterception is lighter and integrates directly with HttpClient, ideal for unit/integration tests without a server. WireMock.NET runs an actual HTTP server, better for end-to-end tests or intercepting requests from non-.NET clients.

Question 4

How to handle authentication in stubbed requests with this library?

Accepted Answer

Use the fluent API to match request headers, such as Authorization, via methods like ForHeader() in HttpRequestInterceptionBuilder. However, it only stubs responses based on static criteria; dynamic token validation isn't supported.

Question 5

Is HttpClientInterception thread-safe for concurrent test execution?

Accepted Answer

The HttpClientInterceptorOptions and builders are designed for test scenarios, but for concurrent tests, ensure each test uses isolated options instances to avoid cross-test interference, as state is captured at registration.

Question 6

Can I use HTTP bundle files for complex API mocking with multiple endpoints?

Accepted Answer

Yes, JSON bundle files allow defining multiple request/response pairs in one file, supporting formats like JSON, HTML, and base64. This is useful for mocking entire API surfaces, but changes require file updates rather than code.

httpclient-interception

What is httpclient-interception?

Overview

Use Cases

Best For

Related Projects

Found a gem we're missing?

Not Ideal For

Pros & Cons

Pros

Cons

Frequently Asked Questions