Skip to content
/ fatal Public

πŸš‘ A handler that recovers from panics

License

Notifications You must be signed in to change notification settings

gowww/fatal

Repository files navigation

gowww fatal GoDoc Build Coverage Go Report Status Stable

Package fatal provides a handler that recovers from panics.

Installing

  1. Get package:

    go get -u github.com/gowww/fatal
  2. Import it in your code:

    import "github.com/gowww/fatal"

Usage

To wrap an http.Handler, use Handle:

mux := http.NewServeMux()

mux.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
	panic("error")
})

http.ListenAndServe(":8080", fatal.Handle(mux, nil))

To wrap an http.HandlerFunc, use HandleFunc:

http.Handle("/", fatal.HandleFunc(func(w http.ResponseWriter, r *http.Request) {
	panic("error")
}, nil))

http.ListenAndServe(":8080", nil)

Custom "error" handler

When your code panics, the response status is set to 500 and an empty body is sent by default.

But you can set your own error handler and retrive the error value with Error.
In this case, it's up to you to set the response status code (normally 500):

http.ListenAndServe(":8080", fatal.Handle(mux, &fatal.Options{
	RecoverHandler: http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
		w.WriteHeader(http.StatusInternalServerError)
		fmt.Fprintf(w, "error: %v", fatal.Error(r))
	}),
}))