exceptions

Jan 26, 2026

Changes in this version

+ func ErrorHandler(handler *Handler) func(http.ResponseWriter, *http.Request, error)

+ func Handle(ctx RenderContext, err error)

+ func HandleWithContext(ctx RenderContext, err error, exCtx *ExceptionContext)

+ func Initialize(opts ...HandlerOption)

+ func IsAPIMode() bool

+ func IsDebug() bool

+ func Middleware(handler *Handler) func(http.Handler) http.Handler

+ func MiddlewareFunc(handler *Handler) func(http.HandlerFunc) http.HandlerFunc

+ func RecoverMiddleware(next http.Handler) http.Handler

+ func Render(ctx RenderContext, err error, exCtx *ExceptionContext)

+ func Report(err error, ctx *ExceptionContext)

+ func ResetGlobal()

+ func SetAPIMode(enabled bool)

+ func SetAPIPrefixes(prefixes ...string)

+ func SetDebug(debug bool)

+ func SetGlobal(handler *Handler)

+ type BadRequestHttpException struct

+ func NewBadRequestHttpException(message ...string) *BadRequestHttpException

+ func (e *BadRequestHttpException) ShouldReport() bool

+ type BaseException struct

+ func NewBaseException(message string, code int) *BaseException

+ func (e *BaseException) Error() string

+ func (e *BaseException) GetCode() int

+ func (e *BaseException) GetContext() map[string]any

+ func (e *BaseException) GetMessage() string

+ func (e *BaseException) GetPrevious() error

+ func (e *BaseException) ShouldReport() bool

+ func (e *BaseException) Unwrap() error

+ func (e *BaseException) WithContext(key string, value any) *BaseException

+ func (e *BaseException) WithContextMap(ctx map[string]any) *BaseException

+ func (e *BaseException) WithPrevious(err error) *BaseException

+ type CallbackReporter struct

+ func NewCallbackReporter(callback func(err error, ctx *ExceptionContext)) *CallbackReporter

+ func (r *CallbackReporter) Report(err error, ctx *ExceptionContext)

+ type ConflictHttpException struct

+ func NewConflictHttpException(message ...string) *ConflictHttpException

+ func (e *ConflictHttpException) ShouldReport() bool

+ type Exception interface

+ GetCode func() int

+ GetContext func() map[string]any

+ GetMessage func() string

+ GetPrevious func() error

+ type ExceptionContext struct

+ Extra map[string]any

+ IP string

+ Method string

+ RequestID string

+ StackTrace *StackTrace

+ Timestamp time.Time

+ TraceID string

+ URL string

+ UserAgent string

+ UserID string

+ func NewExceptionContext() *ExceptionContext

+ func (c *ExceptionContext) WithExtra(key string, value any) *ExceptionContext

+ func (c *ExceptionContext) WithIDs(requestID, traceID string) *ExceptionContext

+ func (c *ExceptionContext) WithRequestInfo(method, url, ip, userAgent string) *ExceptionContext

+ func (c *ExceptionContext) WithStackTrace(st *StackTrace) *ExceptionContext

+ func (c *ExceptionContext) WithUserID(userID string) *ExceptionContext

+ type ForbiddenHttpException struct

+ func NewForbiddenHttpException(message ...string) *ForbiddenHttpException

+ func (e *ForbiddenHttpException) ShouldReport() bool

+ type Frame struct

+ File string

+ Function string

+ Line int

+ Package string

+ func (f *Frame) ShortFile() string

+ type FrameWithSource struct

+ Source []SourceLine

+ SourceErr error

+ type GoneHttpException struct

+ func NewGoneHttpException(message ...string) *GoneHttpException

+ func (e *GoneHttpException) ShouldReport() bool

+ type HTMLRenderer struct

+ func NewHTMLRenderer() *HTMLRenderer

+ func NewHTMLRendererWithTemplates(debugTpl, errorTpl *template.Template) *HTMLRenderer

+ func (r *HTMLRenderer) ContentType() string

+ func (r *HTMLRenderer) Render(ctx RenderContext, err error, exCtx *ExceptionContext, debug bool) error

+ type Handler struct

+ func Get() *Handler

+ func NewHandler(opts ...HandlerOption) *Handler

+ func (h *Handler) AddRenderer(contentType string, renderer Renderer)

+ func (h *Handler) AddReporter(reporter Reporter)

+ func (h *Handler) DontReport(exceptionType string)

+ func (h *Handler) GetAPIPrefixes() []string

+ func (h *Handler) GetEnvironment() string

+ func (h *Handler) Handle(ctx RenderContext, err error)

+ func (h *Handler) HandlePanic(ctx RenderContext, recovered any)

+ func (h *Handler) HandleWithContext(ctx RenderContext, err error, exCtx *ExceptionContext)

+ func (h *Handler) IsAPIMode() bool

+ func (h *Handler) IsDebug() bool

+ func (h *Handler) RegisterCustomHandler(exceptionType any, handler func(RenderContext, error, *ExceptionContext))

+ func (h *Handler) Render(ctx RenderContext, err error, exCtx *ExceptionContext)

+ func (h *Handler) Report(err error, ctx *ExceptionContext)

+ func (h *Handler) SetAPIMode(enabled bool)

+ func (h *Handler) SetAPIPrefixes(prefixes ...string)

+ func (h *Handler) SetDebug(debug bool)

+ func (h *Handler) SetEnvironment(env string)

+ func (h *Handler) SetReporters(reporters ...Reporter)

+ func (h *Handler) ShouldReport(err error) bool

+ type HandlerOption func(*Handler)

+ func WithAPIMode(enabled bool) HandlerOption

+ func WithAPIPrefixes(prefixes ...string) HandlerOption

+ func WithDebug(debug bool) HandlerOption

+ func WithDontReport(types ...string) HandlerOption

+ func WithEnvironment(env string) HandlerOption

+ func WithRenderers(renderers map[string]Renderer) HandlerOption

+ func WithReporters(reporters ...Reporter) HandlerOption

+ type HttpException struct

+ Headers map[string]string

+ StatusCode int

+ func Abort(statusCode int, message ...string) *HttpException

+ func AbortIf(condition bool, statusCode int, message ...string) *HttpException

+ func AbortUnless(condition bool, statusCode int, message ...string) *HttpException

+ func NewHttpException(statusCode int, message string) *HttpException

+ func (e *HttpException) GetHeaders() map[string]string

+ func (e *HttpException) GetStatusCode() int

+ func (e *HttpException) ShouldReport() bool

+ func (e *HttpException) WithHeader(key, value string) *HttpException

+ func (e *HttpException) WithHeaders(headers map[string]string) *HttpException

+ type InternalServerErrorException struct

+ func NewInternalServerErrorException(message ...string) *InternalServerErrorException

+ type JSONRenderer struct

+ func NewJSONRenderer() *JSONRenderer

+ func (r *JSONRenderer) ContentType() string

+ func (r *JSONRenderer) Render(ctx RenderContext, err error, exCtx *ExceptionContext, debug bool) error

+ type LogReporter struct

+ func NewLogReporter(opts ...LogReporterOption) *LogReporter

+ func (r *LogReporter) Report(err error, ctx *ExceptionContext)

+ type LogReporterOption func(*LogReporter)

+ func WithContextKeys(keys ...string) LogReporterOption

+ func WithLogger(logger log.Logger) LogReporterOption

+ func WithoutContext() LogReporterOption

+ type MethodNotAllowedHttpException struct

+ AllowedMethods []string

+ func NewMethodNotAllowedHttpException(allowedMethods []string, message ...string) *MethodNotAllowedHttpException

+ func (e *MethodNotAllowedHttpException) ShouldReport() bool

+ type MultiReporter struct

+ func NewMultiReporter(reporters ...Reporter) *MultiReporter

+ func (r *MultiReporter) AddReporter(reporter Reporter)

+ func (r *MultiReporter) Report(err error, ctx *ExceptionContext)

+ type NotFoundHttpException struct

+ func NewNotFoundHttpException(message ...string) *NotFoundHttpException

+ func (e *NotFoundHttpException) ShouldReport() bool

+ type RenderContext interface

+ GetHeader func(key string) string

+ RequestMethod func() string

+ RequestPath func() string

+ SetHeader func(key, value string)

+ WantsJSON func() bool

+ Write func(data []byte) (int, error)

+ WriteHeader func(statusCode int)

+ type Renderable interface

+ Render func(ctx RenderContext) error

+ type Renderer interface

+ ContentType func() string

+ Render func(ctx RenderContext, err error, exCtx *ExceptionContext, debug bool) error

+ func NegotiateRenderer(ctx RenderContext, renderers map[string]Renderer) Renderer

+ type Reportable interface

+ ShouldReport func() bool

+ type Reporter interface

+ Report func(err error, ctx *ExceptionContext)

+ type ServiceUnavailableException struct

+ RetryAfter int

+ func NewServiceUnavailableException(retryAfter int, message ...string) *ServiceUnavailableException

+ type SourceLine struct

+ Content string

+ Highlight bool

+ Number int

+ func GetSourceContext(file string, line int, contextLines int) ([]SourceLine, error)

+ type StackTrace struct

+ Frames []Frame

+ func CaptureStackTrace(skip int) *StackTrace

+ func (st *StackTrace) GetFramesWithSource(contextLines int) []FrameWithSource

+ func (st *StackTrace) String() string

+ type TooManyRequestsException struct

+ RetryAfter int

+ func NewTooManyRequestsException(retryAfter int, message ...string) *TooManyRequestsException

+ func (e *TooManyRequestsException) ShouldReport() bool

+ type UnauthorizedHttpException struct

+ func NewUnauthorizedHttpException(message ...string) *UnauthorizedHttpException

+ func (e *UnauthorizedHttpException) ShouldReport() bool

+ type ValidationException struct

+ ValidationErrors map[string][]string

+ func NewValidationException(errors map[string][]string, message ...string) *ValidationException

+ func (e *ValidationException) GetValidationErrors() map[string][]string

+ func (e *ValidationException) Render(ctx RenderContext) error

+ func (e *ValidationException) ShouldReport() bool

+ type VelocityContextAdapter struct

+ func NewVelocityContextAdapter(w http.ResponseWriter, r *http.Request) *VelocityContextAdapter

+ func (a *VelocityContextAdapter) GetHeader(key string) string

+ func (a *VelocityContextAdapter) RequestMethod() string

+ func (a *VelocityContextAdapter) RequestPath() string

+ func (a *VelocityContextAdapter) SetHeader(key, value string)

+ func (a *VelocityContextAdapter) WantsJSON() bool

+ func (a *VelocityContextAdapter) Write(data []byte) (int, error)

+ func (a *VelocityContextAdapter) WriteHeader(statusCode int)