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 module

Go to main page

Versions in this module

v1

v1.1.1

Jan 12, 2026

v1.1.0

Nov 22, 2025

v0

v0.2.0

Nov 21, 2025

Changes in this version

+ var ErrCircuitHalfOpen = New("circuit breaker half-open, too many requests")

+ var ErrMaxAttemptsInvalid = New("max retry attempts must be positive")

+ var ErrRetryExhausted = New("retry attempts exhausted")

type CircuitBreakerError

+ Counts CircuitCounts

+ type CircuitCounts struct

+ ConsecutiveFailures uint32

+ ConsecutiveSuccesses uint32

+ Requests uint32

+ TotalFailures uint32

+ TotalSuccesses uint32

type Option

+ func WithCounts(counts CircuitCounts) Option

+ type RetryError struct

+ AllErrors []error

+ Attempts int

+ Component string

+ LastError error

+ MaxAttempts int

+ Operation string

+ func NewRetryError(attempts, maxAttempts int, lastError error, allErrors []error, opts ...Option) *RetryError

+ func (e *RetryError) Error() string

+ func (e *RetryError) IsRetryable() bool

+ func (e *RetryError) Unwrap() error

v0.1.1

Nov 12, 2025

v0.1.0

Nov 12, 2025

Changes in this version

+ var As = errors.As

+ var Cause = errors.Cause

+ var ErrActivityNotFound = errors.New("activity not found")

+ var ErrCircuitOpen = errors.New("circuit breaker open")

+ var ErrConnectionError = errors.New("connection error")

+ var ErrDeadlock = errors.New("database deadlock")

+ var ErrInvalidResponse = errors.New("invalid response")

+ var ErrLocationNotFound = errors.New("location not found")

+ var ErrNetworkTimeout = errors.New("network timeout")

+ var ErrRateLimited = errors.New("rate limited")

+ var ErrServerError = errors.New("server error")

+ var Errorf = errors.Errorf

+ var Is = errors.Is

+ var New = errors.New

+ var Unwrap = errors.Unwrap

+ var WithStack = errors.WithStack

+ var Wrap = errors.Wrap

+ var Wrapf = errors.Wrapf

+ func ExtractErrorInfo(err error) map[string]any

+ func FormatError(err error) string

+ func GetHTTPStatusCode(err error) int

+ func GetSafeDetails(err error) string

+ func GetStackTrace(err error) string

+ func GetStackTraceLines(err error) []string

+ func HasStackTrace(err error) bool

+ func IsContextError(err error) bool

+ func IsNetworkError(err error) bool

+ func IsNotFound(err error) bool

+ func IsPermanentError(err error) bool

+ func IsRetryable(err error) bool

+ func IsRetryableTimeout(err error) bool

+ func IsTimeout(err error) bool

+ func IsTransientError(err error) bool

+ func IsValidation(err error) bool

+ func NewCircuitBreakerError(message, operation, state string, opts ...Option) error

+ func NewHTTPError(statusCode int, message string, cause error) error

+ func NewInternalError(message string, cause error) error

+ func NewNetworkError(message, operation string, opts ...Option) error

+ func NewNotFoundError(message string, cause error) error

+ func NewProcessingError(message, operation string, opts ...Option) error

+ func NewRateLimitError(message, operation string, retryAfter time.Duration, opts ...Option) error

+ func NewRetryableError(message, operation string, retryAfter time.Duration, opts ...Option) error

+ func NewRetryableProcessingError(message, operation string, opts ...Option) error

+ func NewTimeoutError(message, operation string, duration time.Duration, opts ...Option) error

+ func NewValidationError(message, field string, opts ...Option) error

+ type CircuitBreakerError struct

+ Component string

+ Err error

+ Message string

+ Operation string

+ State string

+ func (e *CircuitBreakerError) Error() string

+ func (e *CircuitBreakerError) IsRetryable() bool

+ func (e *CircuitBreakerError) Unwrap() error

+ type HTTPError struct

+ Component string

+ Err error

+ Message string

+ StatusCode int

+ func IsHTTPError(err error) (*HTTPError, bool)

+ func (e *HTTPError) Error() string

+ func (e *HTTPError) IsRetryable() bool

+ func (e *HTTPError) Unwrap() error

+ type NetworkError struct

+ Component string

+ Err error

+ IsTransient bool

+ Message string

+ Operation string

+ func (e *NetworkError) Error() string

+ func (e *NetworkError) IsRetryable() bool

+ func (e *NetworkError) Unwrap() error

+ type Option func(any)

+ func WithCause(cause error) Option

+ func WithComponent(component string) Option

+ func WithField(field string) Option

+ func WithItemID(itemID string) Option

+ func WithMessage(message string) Option

+ func WithOperation(operation string) Option

+ func WithRetryable(retryable bool) Option

+ func WithState(state string) Option

+ func WithStatusCode(statusCode int) Option

+ func WithTransient(transient bool) Option

+ func WithValue(value any) Option

+ type ProcessingError struct

+ Component string

+ Err error

+ ItemID string

+ Message string

+ Operation string

+ Retryable bool

+ func (e *ProcessingError) Error() string

+ func (e *ProcessingError) IsRetryable() bool

+ func (e *ProcessingError) Unwrap() error

+ type RateLimitError struct

+ Component string

+ Err error

+ Message string

+ Operation string

+ RetryAfter time.Duration

+ func (e *RateLimitError) Error() string

+ func (e *RateLimitError) IsRetryable() bool

+ func (e *RateLimitError) Unwrap() error

+ type Retryable interface

+ IsRetryable func() bool

+ type RetryableError struct

+ Component string

+ Err error

+ Message string

+ Operation string

+ RetryAfter time.Duration

+ func (e *RetryableError) Error() string

+ func (e *RetryableError) IsRetryable() bool

+ func (e *RetryableError) Unwrap() error

+ type TimeoutError struct

+ Component string

+ Duration time.Duration

+ Err error

+ Message string

+ Operation string

+ func (e *TimeoutError) Error() string

+ func (e *TimeoutError) IsRetryable() bool

+ func (e *TimeoutError) Unwrap() error

+ type ValidationError struct

+ Component string

+ Err error

+ Field string

+ Message string

+ Value any

+ func (e *ValidationError) Error() string

+ func (e *ValidationError) IsRetryable() bool

+ func (e *ValidationError) Unwrap() error