Cutec.Blazor.WebAPIs 2.0.0

Blazor.WebAPIs

This is a Blazor library for accessing APIs provided by web browser: IndexedDB, window.localStorage...(more to come)

To use the library

1. Instal NuGet package: Cutec.Blazor.WebAPIs.
2. Add script reference to index.html: <script src="_content/Cutec.Blazor.WebAPIs/All.js"></script>
3. Register services; builder.Services.AddBlazorWebAPIs();. Alternatively, you can register the needed indivitial API, ex. builder.Services.AddWebStorage();

IndexedDB APIs

Warning: If Key/AutoIncrement definition is changed, the object store will be re-created and data will be lost.

It is based on idb.

Inherit from IndexedDb:

public class DbContext : IndexedDb
{
    public ObjectStore<ToDo> ToDos { get; set; }
}    

In Program.cs

builder.Services.AddIndexedDB<DbContext>();

var host = builder.Build();

await host.Services.UseIndexedDbAsync<DbContext>(options =>
{
  options.Name = "MyDb";
  options.Version = 1;
});

Inject DbContent into Components:

[Inject] private DbContext db { get; set; }

...

var toDos = await db.ToDos.GetAllAsync();

Retrieving

• GetByKeyAsync, GetFirstByKeyRangeAsync, GetFirstFromIndexAsync
• GetAllAsync, GetAllFromIndexAsync, GetAllByIndexValueAsync, GetAllByKeyListAsync
• GetAllKeysAsync, GetAllKeysFromIndexAsync, GetAllKeysByIndexValueAsync, GetFirstKeyAsync
• GetAllIndexValuesAsync
• CountAsync

Update

• PutAsync
• PutListAsync

Delete

• DeleteByKeyAsync
• DeleteByKeyListAsync
• ClearAsync
• ClearDbAsync

LocalStorage/SessionStorage

Inject LocalStorage:

[Inject] private LocalStorage localStorage { get; set; }

APIs

int Length
string Key(int index)
string GetItem(string keyName)
void SetItem(string keyName, string keyValue)
void RemoveItem(string keyName)
void Clear()

T GetItem<T>(string keyName) where T : class
void SetItem<T>(string keyName, T item) where T : class

Geolocation

Inject and use Geolocation.