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
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

errors

package

Go to main page

Versions in this module

v1

v1.2.0

Aug 1, 2025

v1.1.0

Aug 9, 2025

v1.0.3

Nov 28, 2025

v1.0.2

Nov 27, 2025

v1.0.1

Nov 27, 2025

v1.0.0

Aug 8, 2025

Changes in this version

+ func GetHTTPStatus(err error) int

+ func HasCode(err error, code ErrorCode) bool

+ func IsAppError(err error) bool

+ func IsRetryable(err error) bool

+ type AppError struct

+ Cause error

+ Code ErrorCode

+ Context map[string]interface{}

+ Message string

+ RequestID string

+ Retryable bool

+ Severity Severity

+ StackTrace string

+ Timestamp time.Time

+ UserID string

+ func GetAppError(err error) *AppError

+ func New(code ErrorCode, message string) *AppError

+ func NewAlreadyExistsError(resource, id string) *AppError

+ func NewAppError(code ErrorCode, message string) *AppError

+ func NewConfigError(key, reason string) *AppError

+ func NewDatabaseError(operation string, err error) *AppError

+ func NewForbiddenError(resource string) *AppError

+ func NewInternalError(message string) *AppError

+ func NewInvalidInputError(field, value string) *AppError

+ func NewMissingRequiredError(field string) *AppError

+ func NewNetworkError(message string) *AppError

+ func NewNotFoundError(resource, id string) *AppError

+ func NewPanicError(recovered interface{}) *AppError

+ func NewParsingError(format, input string) *AppError

+ func NewProcessingError(message string) *AppError

+ func NewRateLimitError(limit int, window time.Duration) *AppError

+ func NewTimeoutError(operation string, timeout time.Duration) *AppError

+ func NewUnauthorizedError(message string) *AppError

+ func NewValidationError(message string) *AppError

+ func Newf(code ErrorCode, format string, args ...interface{}) *AppError

+ func Wrap(err error, code ErrorCode, message string) *AppError

+ func Wrapf(err error, code ErrorCode, format string, args ...interface{}) *AppError

+ func (e *AppError) Error() string

+ func (e *AppError) GetCode() ErrorCode

+ func (e *AppError) GetSeverity() Severity

+ func (e *AppError) Is(target error) bool

+ func (e *AppError) IsRetryable() bool

+ func (e *AppError) Unwrap() error

+ func (e *AppError) WithContext(key string, value interface{}) *AppError

+ func (e *AppError) WithRequestID(requestID string) *AppError

+ func (e *AppError) WithUserID(userID string) *AppError

+ type EnhancedError struct

+ Category ErrorCategory

+ Cause error

+ Code string

+ Component string

+ Context map[string]interface{}

+ Documentation string

+ Examples []string

+ Explanation string

+ Message string

+ Severity ErrorSeverity

+ StackTrace string

+ Suggestions []string

+ Timestamp string

+ UserMessage string

+ func ErrConfigFileNotFound(path string) *EnhancedError

+ func ErrDependencyNotFound(dependency string) *EnhancedError

+ func ErrInvalidConfiguration(field string, value interface{}) *EnhancedError

+ func ErrNetworkTimeout(url string) *EnhancedError

+ func ErrPermissionDenied(path string) *EnhancedError

+ func (e *EnhancedError) Error() string

+ func (e *EnhancedError) Unwrap() error

+ type ErrorBuilder struct

+ func ConfigurationError(code, message string) *ErrorBuilder

+ func DependencyError(code, message string) *ErrorBuilder

+ func NetworkError(code, message string) *ErrorBuilder

+ func NewError(code, message string) *ErrorBuilder

+ func PermissionError(code, message string) *ErrorBuilder

+ func UsageError(code, message string) *ErrorBuilder

+ func ValidationError(code, message string) *ErrorBuilder

+ func (b *ErrorBuilder) Build() *EnhancedError

+ func (b *ErrorBuilder) Category(category ErrorCategory) *ErrorBuilder

+ func (b *ErrorBuilder) Cause(cause error) *ErrorBuilder

+ func (b *ErrorBuilder) Component(component string) *ErrorBuilder

+ func (b *ErrorBuilder) Context(key string, value interface{}) *ErrorBuilder

+ func (b *ErrorBuilder) Documentation(url string) *ErrorBuilder

+ func (b *ErrorBuilder) Example(example string) *ErrorBuilder

+ func (b *ErrorBuilder) Explanation(explanation string) *ErrorBuilder

+ func (b *ErrorBuilder) Severity(severity ErrorSeverity) *ErrorBuilder

+ func (b *ErrorBuilder) Suggestion(suggestion string) *ErrorBuilder

+ func (b *ErrorBuilder) Suggestions(suggestions ...string) *ErrorBuilder

+ func (b *ErrorBuilder) UserMessage(message string) *ErrorBuilder

+ type ErrorCategory string

+ const CategoryConfiguration

+ const CategoryDependency

+ const CategoryInternal

+ const CategoryNetwork

+ const CategoryPermission

+ const CategoryUsage

+ const CategoryValidation

+ type ErrorCode string

+ const CACHE_ERROR

+ const CACHE_MISS

+ const CONFIG_ERROR

+ const CONFIG_VALIDATION_ERROR

+ const DB_CONNECTION_ERROR

+ const DB_QUERY_ERROR

+ const DB_TRANSACTION_ERROR

+ const ErrCodeAlreadyExists

+ const ErrCodeAuth

+ const ErrCodeConfig

+ const ErrCodeConstraint

+ const ErrCodeDatabase

+ const ErrCodeDecoding

+ const ErrCodeEncoding

+ const ErrCodeForbidden

+ const ErrCodeInternal

+ const ErrCodeInvalidConfig

+ const ErrCodeInvalidInput

+ const ErrCodeMissingConfig

+ const ErrCodeMissingRequired

+ const ErrCodeNetwork

+ const ErrCodeNotFound

+ const ErrCodePanic

+ const ErrCodeParsing

+ const ErrCodePermissionDenied

+ const ErrCodeProcessing

+ const ErrCodeQuotaExceeded

+ const ErrCodeRateLimit

+ const ErrCodeServiceUnavailable

+ const ErrCodeTimeout

+ const ErrCodeTokenExpired

+ const ErrCodeTransaction

+ const ErrCodeUnauthorized

+ const ErrCodeUnknown

+ const ErrCodeValidation

+ const FORBIDDEN

+ const INTERNAL_ERROR

+ const INVALID_INPUT

+ const INVALID_PACKAGE

+ const ML_MODEL_ERROR

+ const ML_PREDICTION_ERROR

+ const NOT_FOUND_ERROR

+ const PACKAGE_NOT_FOUND

+ const RATE_LIMITED

+ const SCAN_FAILED

+ const UNAUTHORIZED

+ const VALIDATION_ERROR

+ type ErrorFormatter struct

+ func NewErrorFormatter(colorEnabled, verboseMode bool) *ErrorFormatter

+ func (f *ErrorFormatter) Format(err *EnhancedError) string

+ type ErrorList struct

+ Errors []*AppError

+ func NewErrorList() *ErrorList

+ func (el *ErrorList) Add(err *AppError)

+ func (el *ErrorList) AddError(err error)

+ func (el *ErrorList) Clear()

+ func (el *ErrorList) Count() int

+ func (el *ErrorList) Error() string

+ func (el *ErrorList) First() *AppError

+ func (el *ErrorList) HasErrors() bool

+ type ErrorSeverity string

+ const ErrorSeverityCritical

+ const ErrorSeverityHigh

+ const ErrorSeverityLow

+ const ErrorSeverityMedium

+ type Severity string

+ const SeverityCritical

+ const SeverityHigh

+ const SeverityLow

+ const SeverityMedium

+ func GetSeverity(err error) Severity