Method WithReportError

server/middlewares.go:94–138

WithReportError handles error reporting. It should be placed after `WithMonitoring`, but before `WithPanic`.

(h RouteHandler)

// WithReportError handles error reporting.
// It should be placed after `WithMonitoring`, but before `WithPanic`.
func (r *Router) WithReportError(h RouteHandler) RouteHandler {
	return func(reqID string, rw ResponseWriter, req *http.Request) *Error {
		// Open the error context
		ctx := errorreport.StartRequest(req)
		req = req.WithContext(ctx)
		errorreport.SetMetadata(req, "Request ID", reqID)

		// Call the underlying handler passing the context downwards
		err := h(reqID, rw, req)
		if err == nil {
			return nil
		}

		// We do not need to send any canceled context
		if !errors.Is(err.Err, context.Canceled) {
			r.monitoring.SendError(ctx, err.Category, err.Err)
		}

		// Report error to error collectors
		if err.Err.ShouldReport() {
			r.errorReporter.Report(err.Err, req)
		}

		// Log response and format the error output
		LogResponse(reqID, req, err.Err.StatusCode(), err.Err)

		// Error message: either is public message or full development error
		if r.config.DevelopmentErrorsMode {
			// Generate and serve HTML error page
			html, contentType := generateErrorHTML(err.Err, reqID, req.Header)

			rw.Header().Set(httpheaders.ContentType, contentType)
			rw.WriteHeader(err.Err.StatusCode())
			rw.Write(html)

			return nil
		}

		rw.Header().Set(httpheaders.ContentType, "text/plain")
		rw.WriteHeader(err.Err.StatusCode())
		rw.Write([]byte(err.Err.PublicMessage()))

		return nil
	}
}