set_error_handler

Description

Register the process-wide error handler. Call this once, early (typically from src/app.rs main()); a later call is ignored (the first registration wins). The handler runs on every error thrown by a request handler. Return Some(response) to send a custom HTTP response, or None to fall back to Ossido's default error page / JSON. See the module docs.

Register once, early (typically from src/app.rs main()), before the server starts - the first registration wins. The closure runs for every error thrown by a handler or action.

Signature

pub fn set_error_handler<F, Fut>(handler: F) where F: Fn(ErrorContext) -> Fut + Send + Sync + 'static, Fut: Future<Output = Option<AxumResponse>> + Send + 'static

Examples

// src/app.rs
set_error_handler(|ctx: ErrorContext| async move {
    report(&ctx.error).await;
    None // None → Ossido renders its default error page / JSON
});

use ossido::axum::{http::StatusCode, response::IntoResponse, Json};

set_error_handler(|ctx: ErrorContext| async move {
    report(&ctx.error).await;
    Some((StatusCode::INTERNAL_SERVER_ERROR, Json(ErrorBody { id: ctx.error_id })).into_response())
});