This library provides access to browser API in a Blazor App.
The following criteria are taken into account for choosing if an API must be handled :
- Is it already doable with Blazor (like XHR, DOM manipulation or already managed event ) ?
- Is that part of the standard ?
- Is that implemented by most browsers ? (> 75% in caniuse)
This library aim at providing some added value which are :
- Better deserialization than default : DomString, Infinity, Array-like map ...
- Better typing : duration as TimeSpan, string as enum ...
- Use IAsyncDisposable for method call that must be executed around a code block (like profiling) or event subscription
- Func for event subscription
I use the following website for discovering API description https://developer.mozilla.org/en-US/docs/Web/API and this one for finding out if it is implemented https://caniuse.com/.
First install the package
dotnet add package BrowserInterop
Reference the needed JS in your index.html (or in your js bundling tool)
<script src="_content/BrowserInterop/scripts.js"></script>Then in your template enter the API with the Window() extension method like this :
@using BrowserInterop.Extensions
...
@code {
protected override async Task OnInitialized()
{
var window = await jsRuntime.Window();
await window.Console.Log("this is a {0}","Log message");
}
}