handler

Documentation

Index

• func NewTimeoutHandler(h http.Handler, msg string, timeout time.Duration, ...) http.Handler

Functions

func NewTimeoutHandler

func NewTimeoutHandler(h http.Handler, msg string, timeout time.Duration, responseStartTimeout time.Duration, idleTimeout time.Duration) http.Handler

NewTimeoutHandler returns a Handler that runs `h` with the given timeout in which the first byte of the response must be written, and with the given idle timeout

The new Handler calls h.ServeHTTP to handle each request, but if a call runs for longer than its time limit, the handler responds with a 504 Gateway Timeout error and the given message in its body. (If msg is empty, a suitable default message will be sent.) After such a timeout, writes by h to its ResponseWriter will return ErrHandlerTimeout.

A panic from the underlying handler is propagated as-is to be able to make use of custom panic behavior by HTTP handlers. See https://golang.org/pkg/net/http/#Handler.

The implementation is largely inspired by http.TimeoutHandler.