Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
- API
  
  Reference documentation for the pkg.go.dev API
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

errenvelope

package module

Go to main page

Versions in this module

v1

v1.1.0

Dec 23, 2025

Changes in this version

type Error

+ func BadRequestf(format string, args ...any) *Error

+ func Conflictf(format string, args ...any) *Error

+ func Forbiddenf(format string, args ...any) *Error

+ func Internalf(format string, args ...any) *Error

+ func Newf(code Code, status int, format string, args ...any) *Error

+ func NotFoundf(format string, args ...any) *Error

+ func Timeoutf(format string, args ...any) *Error

+ func Unauthorizedf(format string, args ...any) *Error

+ func Unavailablef(format string, args ...any) *Error

+ func Wrapf(code Code, status int, format string, cause error, args ...any) *Error

+ func (e *Error) MarshalJSON() ([]byte, error)

v1.0.0

Dec 7, 2025

Changes in this version

+ const HeaderTraceID

+ func Is(err error, code Code) bool

+ func TraceIDFromRequest(r *http.Request) string

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

+ func WithTraceID(ctx context.Context, id string) context.Context

+ func Write(w http.ResponseWriter, r *http.Request, err error)

+ type Code string

+ const CodeBadRequest

+ const CodeCanceled

+ const CodeConflict

+ const CodeDownstream

+ const CodeDownstreamTimeout

+ const CodeForbidden

+ const CodeGone

+ const CodeInternal

+ const CodeMethodNotAllowed

+ const CodeNotFound

+ const CodePayloadTooLarge

+ const CodeRateLimited

+ const CodeRequestTimeout

+ const CodeTimeout

+ const CodeUnauthorized

+ const CodeUnavailable

+ const CodeUnprocessableEntity

+ const CodeValidationFailed

+ type Error struct

+ Cause error

+ Code Code

+ Details any

+ Message string

+ RetryAfter time.Duration

+ Retryable bool

+ Status int

+ TraceID string

+ func BadRequest(msg string) *Error

+ func Conflict(msg string) *Error

+ func Downstream(service string, cause error) *Error

+ func DownstreamTimeout(service string, cause error) *Error

+ func Forbidden(msg string) *Error

+ func From(err error) *Error

+ func Gone(msg string) *Error

+ func Internal(msg string) *Error

+ func MethodNotAllowed(msg string) *Error

+ func New(code Code, status int, msg string) *Error

+ func NotFound(msg string) *Error

+ func PayloadTooLarge(msg string) *Error

+ func RateLimited(msg string) *Error

+ func RequestTimeout(msg string) *Error

+ func Timeout(msg string) *Error

+ func Unauthorized(msg string) *Error

+ func Unavailable(msg string) *Error

+ func UnprocessableEntity(msg string) *Error

+ func Validation(fields FieldErrors) *Error

+ func Wrap(code Code, status int, msg string, cause error) *Error

+ func (e *Error) Error() string

+ func (e *Error) LogValue() slog.Value

+ func (e *Error) Unwrap() error

+ func (e *Error) WithDetails(details any) *Error

+ func (e *Error) WithRetryAfter(d time.Duration) *Error

+ func (e *Error) WithRetryable(v bool) *Error

+ func (e *Error) WithStatus(status int) *Error

+ func (e *Error) WithTraceID(id string) *Error

+ type FieldErrors map[string]string

+ type ValidationDetails struct

+ Fields FieldErrors