Struct poem::middleware::CatchPanic

pub struct CatchPanic<H> { /* private fields */ }

Middleware for catches panics and converts them into 500 INTERNAL SERVER ERROR responses.

Example

use http::StatusCode;
use poem::{handler, middleware::CatchPanic, test::TestClient, EndpointExt, Route};

#[handler]
async fn index() {
    panic!()
}

let app = Route::new().at("/", index).with(CatchPanic::new());

let cli = TestClient::new(app);
let resp = cli.get("/").send().await;
resp.assert_status(StatusCode::INTERNAL_SERVER_ERROR);

Implementations

impl CatchPanic<()>

pub fn new() -> Self

Create new CatchPanic middleware.

impl<H> CatchPanic<H>

pub fn with_handler<T: PanicHandler>(self, handler: T) -> CatchPanic<T>

Specifies a panic handler to be used to create a custom response when a panic occurs.

Example

use http::StatusCode;
use poem::{
    handler, middleware::CatchPanic, test::TestClient, EndpointExt, IntoResponse, Route,
};

#[handler]
async fn index() {
    panic!()
}

let app = Route::new().at("/", index).with(
    CatchPanic::new().with_handler(|_| "error!".with_status(StatusCode::INTERNAL_SERVER_ERROR)),
);

let cli = TestClient::new(app);
let resp = cli.get("/").send().await;
resp.assert_status(StatusCode::INTERNAL_SERVER_ERROR);
resp.assert_text("error!").await;

Trait Implementations

impl Default for CatchPanic<()>

fn default() -> Self

Returns the “default value” for a type.

impl<E: Endpoint, H: PanicHandler> Middleware<E> for CatchPanic<H>

type Output = CatchPanicEndpoint<E, H>

New endpoint type.

fn transform(&self, ep: E) -> Self::Output

Transform the input Endpoint to another one.