AnoiAsyncDebouncer

A lightweight, high-performance async debouncer for .NET with typed return values and cancellation token support.

Features

• Typed return values - Generic AsyncDebouncer<T> supports any return type
• Cancellation support - Proper cancellation token propagation
• Thread-safe - Safe for concurrent access
• Flush support - Execute pending operations immediately
• Memory efficient - Uses object pooling for CancellationTokenSource instances
• Zero dependencies - Only depends on .NET Standard 2.1
• Non-generic version - AsyncDebouncer for void operations

Installation

dotnet add package AnoiAsyncDebouncer

Or via Package Manager:

Install-Package AnoiAsyncDebouncer

Quick Start

Basic Usage (with return value)

using AnoiAsyncDebouncer;

// Create a debouncer for string results
var debouncer = new AsyncDebouncer<string>();

// Debounce an async operation with 300ms delay
var result = await debouncer.DebounceAsync(async cancellationToken =>
{
    return await SearchApiAsync(searchTerm, cancellationToken);
}, delayMilliseconds: 300);

Void Operations

// For operations without return values
var debouncer = new AsyncDebouncer();

await debouncer.DebounceAsync(async cancellationToken =>
{
    await SaveDataAsync(cancellationToken);
}, delayMilliseconds: 500);

Blazor Search Example

@inject HttpClient Http
@implements IDisposable

<input @oninput="OnSearchInput" placeholder="Search..." />

@code {
    private readonly AsyncDebouncer<List<string>> _searchDebouncer = new();
    private List<string> searchResults = new();

    private async Task OnSearchInput(ChangeEventArgs e)
    {
        var searchTerm = e.Value?.ToString() ?? "";
        
        searchResults = await _searchDebouncer.DebounceAsync(async ct =>
        {
            if (string.IsNullOrWhiteSpace(searchTerm))
                return new List<string>();
                
            return await Http.GetFromJsonAsync<List<string>>(
                $"api/search?q={searchTerm}", ct) ?? new List<string>();
        }, 300, defaultValue: new List<string>());
        
        StateHasChanged();
    }

    public void Dispose() => _searchDebouncer.Dispose();
}