Toolbelt.Blazor.HttpClientInterceptor 10.1.0

.NET Standard 2.1
Install-Package Toolbelt.Blazor.HttpClientInterceptor -Version 10.1.0
dotnet add package Toolbelt.Blazor.HttpClientInterceptor --version 10.1.0
<PackageReference Include="Toolbelt.Blazor.HttpClientInterceptor" Version="10.1.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Toolbelt.Blazor.HttpClientInterceptor --version 10.1.0
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
#r "nuget: Toolbelt.Blazor.HttpClientInterceptor, 10.1.0"
#r directive can be used in F# Interactive, C# scripting and .NET Interactive. Copy this into the interactive tool or source code of the script to reference the package.
// Install Toolbelt.Blazor.HttpClientInterceptor as a Cake Addin
#addin nuget:?package=Toolbelt.Blazor.HttpClientInterceptor&version=10.1.0

// Install Toolbelt.Blazor.HttpClientInterceptor as a Cake Tool
#tool nuget:?package=Toolbelt.Blazor.HttpClientInterceptor&version=10.1.0
The NuGet Team does not provide support for this client. Please contact its maintainers for support.

Blazor WebAssembly (client-side) HttpClient Interceptor NuGet Package


The class library that intercept all of the sending HTTP requests on a client side Blazor WebAssembly application.

Supported Blazor versions

"Blazor WebAssembly App (client-side) HttpClient Interceptor" ver.9.x supports Blazor WebAssembly App version 3.2 Preview 2+, and Release Candidates, of course, 3.2.x official release, and .NET 5, 6, 7 are also supported.

How to install and use?

Step.1 Install the library via NuGet package, like this.

> dotnet add package Toolbelt.Blazor.HttpClientInterceptor

Step.2 Register IHttpClientInterceptor service into the DI container, at Main() method in the Program class of your Blazor application.

using Toolbelt.Blazor.Extensions.DependencyInjection; // <- Add this, and...
public class Program
  public static async Task Main(string[] args)
    var builder = WebAssemblyHostBuilder.CreateDefault(args);
    builder.Services.AddHttpClientInterceptor(); // <- Add this!

Step.3 Add invoking EnableIntercept(IServiceProvider) extension method at the registration of HttpClient to DI container.

public class Program
  public static async Task Main(string[] args)
    builder.Services.AddScoped(sp => new HttpClient { 
      BaseAddress = new Uri(builder.HostEnvironment.BaseAddress) 
    }.EnableIntercept(sp)); // <- Add this!

That's all.

You can subscribe the events that will occur before/after sending all of the HTTP requests, at anywhere you can get IHttpClientInterceptor service from the DI container.

@using Toolbelt.Blazor
@inject IHttpClientInterceptor Interceptor
@code {
  protected override void OnInitialized()
    this.Interceptor.BeforeSend += Interceptor_BeforeSend;

  void Interceptor_BeforeSend(object sender, HttpClientInterceptorEventArgs e)
    // Do something here what you want to do.

If you want to do async operations inside the event handler, please subscribe async version events such as BeforeSendAsync and AfterSendAsync, instead of BeforeSend and AfterSend.

Note: Please remember that if you use IHttpClientInterceptor to subscribe BeforeSend/BeforeSendAsync/AfterSend/AfterSendAsync events in Blazor components (.razor), you should unsubscribe events when the components is discarded. To do it, you should implement IDisposable interface in that component, like this code:

@implements IDisposable
public void Dispose()
  this.Interceptor.BeforeSend -= Interceptor_BeforeSend;

The arguments of event handler

The event handler for BeforeSend/BeforeSendAsync/AfterSend/AfterSendAsync events can be received HttpClientInterceptorEventArgs object.

The HttpClientInterceptorEventArgs object provides you to a request object and a response object that is come from an intercepted HttpClinet request.

void OnAfterSend(object sender, HttpClientInterceptorEventArgs args)
  if (!args.Response?.IsSuccessStatusCode) {
    // Do somthing here for handle all errors of HttpClient requests.

To read the content at "AfterSendAsync" event handler

If you want to read the content in the Response object at the event handler for AfterSendAsync event, don't reference the Response.Content property directly to do it.

Instead, please use the return value of the GetCapturedContentAsync() method.

Note: Please remember that the GetCapturedContentAsync() method has a little bit performance penalty.
Because in the GetCapturedContentAsync() method, the LoadIntoBufferAsync() method of the Response.Content property is invoked.

async Task OnAfterSendAsync(object sender, HttpClientInterceptorEventArgs args)
  // 👇 Don't reference "args.Response.Content" directly to read the content.
  // var content = await args.Response.Content.ReadAsStringAsync()

  // 👇 Instead, please use the return value of the "GetCapturedContentAsync()" method.
  var capturedContent = await arg.GetCapturedContentAsync();
  var content = await capturedContent.ReadAsStringAsync();

Cancel a request before sending

If you want to cancel the request before sending it, you can do it by setting false to the Cancel property of the BeforeSend/BeforeSendAsync event argument.

void OnBeforeSend(object sender, HttpClientInterceptorEventArgs args)
  if (/*something wron*/) {
    // 👇 Setting the "Cancel" to true will cancel sending a request.
    args.Cancel = true;

In that case, a HttpClient object will return the HttpResponseMessage object with HTTP status code "NoContent" (HTTP 204) to the caller, and also the AfterSend/AfterSendAsync event will not be fired.

Release Notes

Release notes is here.


Mozilla Public License Version 2.0

Product Versions
.NET net5.0 net5.0-windows net6.0 net6.0-android net6.0-ios net6.0-maccatalyst net6.0-macos net6.0-tvos net6.0-windows
.NET Core netcoreapp3.0 netcoreapp3.1
.NET Standard netstandard2.1
MonoAndroid monoandroid
MonoMac monomac
MonoTouch monotouch
Tizen tizen60
Xamarin.iOS xamarinios
Xamarin.Mac xamarinmac
Xamarin.TVOS xamarintvos
Xamarin.WatchOS xamarinwatchos
Compatible target framework(s)
Additional computed target framework(s)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (5)

Showing the top 5 NuGet packages that depend on Toolbelt.Blazor.HttpClientInterceptor:

Package Downloads

Insert loading bar UI automatically into a client side Blazor application.


Package Description


Package Description


Package Description


Identity helper and configuration for Blazor WASM token based authorization

GitHub repositories (1)

Showing the top 1 popular GitHub repositories that depend on Toolbelt.Blazor.HttpClientInterceptor:

Repository Stars
Clean Architecture Template for Blazor WebAssembly Built with MudBlazor Components.
Version Downloads Last updated
10.1.0 21,417 2/18/2022
10.0.0 54,199 8/21/2021
9.2.1 50,386 11/10/2020
9.2.0-preview.1 811 9/26/2020
9.1.0 4,064 9/11/2020
9.1.0-preview.1 164 9/9/2020
9.0.1 32,769 7/22/2020
9.0.0 9,200 4/25/2020
8.0.1 2,564 3/12/2020
8.0.0 213 3/11/2020
7.0.0 9,992 1/29/2020
6.1.0 296 1/24/2020
6.0.0 3,070 11/20/2019
5.0.0 3,348 6/14/2019 616 4/26/2019
3.0.0 665 2/8/2019
2.1.0 1,212 10/3/2018
2.0.0 600 9/21/2018
1.0.0 653 9/14/2018

- Improve: The HttpClientInterceptorEventArgs class includes the exception object if an HTTP request has thrown an exception.