This package is a compatibility library for Microsoft ASP.NET Core SignalR to allow it to run on Microsoft ASP.NET Blazor.
The package is an addon for the existing .net client for SingalR, this is unlike the BlazorExtensions/SignalR
package which emulates the c# api. This package instead works by replacing the transport mechanics, meaning the front facing SignalR api is still the standard .net one. The benefits of this setup is that as SignalR changes, this package takes little maintenance, as it only replaces the transport mechanisms, which are unlikely to change.
For more information about SignalR development, please check SignalR documentation.
- Uses standard SignalR Core .NET client
- Allows multiple hub connections
- Supports all transports (Long polling, Side side events and websockets)
- Wide compatability (Automatic transport fallback ensure it works on all platforms)
- Supports authentication
Install the nuget package (or use the GUI in VS and search)
Install-Package BlazorSignalR
And then configure your connection creation like the following:
@inject IJSRuntime JsRuntime
HubConnection connection = new HubConnectionBuilder().WithUrlBlazor("/chathub", JsRuntime,
options: opt => {
opt.AccessTokenProvider = async () =>
{
return "some token for example";
};
}).Build();
Follow the official docs for the .NET core client.
All transports work
You will require browser support for WebSocket and EventSource for those transports to be enabled. You can install polyfils if you wish, as otherwise signalr will fallback to long polling.
You can manually select what transports and the implementations to use via Transports
& Implementations
in the BlazorHttpConnectionOptions
when configuring the builder.
- Long Polling (Implemented in C#)
- Server Side Events (Implemented in JS, C# implementation waiting on Blazor bug)
- Web Sockets (Implemented in JS, C# implementation waiting on mono support)
JS implemented means that the network requests are proxied to and from Javascript at a high level, whereas C# implemented means most of the processing occurs within the mono wasm runtime, with the low level networking being proxied back and forth. JS implementations should be faster as they use the underlying browser mechanisms.
Blazor | BlazorSignalR |
---|---|
3.0.0-preview8 | 0.9.x |
3.0.0-preview7 | 0.8.x |
3.0.0-preview6 | 0.7.x |
3.0.0-preview4 | 0.6.x |
0.9.x | 0.5.x |
0.8.x | 0.4.x |
<= 0.7.x | <= 0.3.x |
The version of BlazorSignalR
is tied lightly to the version of Blazor
you are running. Generally the package is forwards compatible, however Blazor
does have breaking changes once in a while, requiring a breaking BlazorSignalR
version.
Uses the typescript client, exposed to C# via a shim api that relays back to typescript. This has the benefit of being extreemly reliable and fast, however at the expense of each feature needing to be hand exposed, meaning the api does not perfectly reflect the .net api.
This package uses the test suite from the BlazorExtensions/SignalR
package and was based on their work. Please do check it out!