Error

IsabyteError

The IsabyteError system intercepts render exceptions and HTTP errors before they crash the Blazor circuit, displaying branded error templates with Development/Production modes and context-sensitive recovery actions.

Error Parameters

Trigger Errors

Click a button to simulate an error and see the corresponding template:

Quick HTTP codes:

Click a trigger button above to preview an error template.

Current Configuration

📋

<!-- Error handling is enabled on IsabyteRootComponent -->
<IsabyteRootComponent EnableErrorHandling="true"
                  IsDevelopment="true">
    @Body
</IsabyteRootComponent>

<!-- Errors are caught automatically. To trigger manually: -->
@code {
    [CascadingParameter]
    public IsabyteErrorState? ErrorState { get; set; }

    void ShowError() => ErrorState?.ShowHttpError(404);
}

@code {
// Display mode: Development
// Current preview: None

// Enable error handling in BaseLayout.razor:
<IsabyteRootComponent EnableErrorHandling="true"
                  IsDevelopment="true"
                  OnError="HandleError">
    @Body
</IsabyteRootComponent>

// Handle errors with a callback:
private async Task HandleError(IsabyteErrorEventArgs args)
{
    await _logger.LogAsync(args.ErrorContext);
    // args.Handled = true; // Suppress IsabyteError UI
}

// Register HttpClient error interception:
builder.Services.AddScoped<IsabyteErrorState>();
builder.Services.AddScoped<IsabyteHttpErrorHandler>();
builder.Services.AddHttpClient("API")
    .AddHttpMessageHandler<IsabyteHttpErrorHandler>();
}