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

v0

v0.1.9

Jan 11, 2026

v0.1.8

Jan 10, 2026

v0.1.7

Jan 9, 2026

v0.1.6

Jan 9, 2026

v0.1.4

Jan 9, 2026

v0.1.3

Jan 8, 2026

v0.1.2

Jan 8, 2026

v0.1.1

Jan 8, 2026

v0.1.0

Jan 8, 2026

Changes in this version

+ var DebugMode = false

+ func As(err error, target interface{}) bool

+ func Chain(err error) []error

+ func DisableDebugMode()

+ func EnableDebugMode()

+ func ExampleAdvancedCircuitBreaker_usage()

+ func ExampleProviderRecoveryStrategy_apiKeyResolution()

+ func ExampleProviderRecoveryStrategy_basic()

+ func ExampleProviderRecoveryStrategy_customConfig()

+ func ExampleProviderRecoveryStrategy_fromConfig()

+ func ExampleProviderRecoveryStrategy_integration()

+ func ExampleProviderRecoveryStrategy_rateLimit()

+ func ExampleProviderRecoveryStrategy_serverError()

+ func ExampleProviderRecoveryStrategy_timeoutIncrease()

+ func ExampleProviderRecoveryStrategy_tokenReduction()

+ func Fallback(primary func() error, fallback func() error) error

+ func FallbackWithValue[T any](primary func() (T, error), fallbackValue T) (T, error)

+ func Format(err error) string

+ func FormatChain(err error) string

+ func FormatUser(err error) string

+ func FromJSON(data []byte) error

+ func Is(err, target error) bool

+ func IsDebugMode() bool

+ func IsRetryable(err error) bool

+ func Retry(ctx context.Context, fn func() error, config *RetryConfig) error

+ func RetryWithRecovery(ctx context.Context, fn func() error, config *RetryConfig, ...) error

+ func RootCause(err error) error

+ func ToJSON(err error) ([]byte, error)

+ func Unwrap(err error) error

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

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

+ type AdvancedCircuitBreaker struct

+ func NewAdvancedCircuitBreaker(maxFailures int, resetTimeout time.Duration) *AdvancedCircuitBreaker

+ func (acb *AdvancedCircuitBreaker) ExecuteWithErrorType(fn func() error, errorType string) error

+ func (acb *AdvancedCircuitBreaker) SetErrorThreshold(errorType string, threshold int)

+ type AuthenticationError struct

+ Provider string

+ Resource string

+ UserID string

+ func NewAuthFailedError(provider string, cause error) *AuthenticationError

+ func NewAuthenticationError(code ErrorCode, message string) *AuthenticationError

+ func NewExpiredTokenError(provider string) *AuthenticationError

+ func NewInvalidCredentialsError(provider string) *AuthenticationError

+ func NewInvalidTokenError(provider string) *AuthenticationError

+ func NewPermissionDeniedError(resource, action string) *AuthenticationError

+ func (e *AuthenticationError) WithProvider(provider string) *AuthenticationError

+ func (e *AuthenticationError) WithResource(resource string) *AuthenticationError

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

+ type BaseError struct

+ func (e *BaseError) Code() ErrorCode

+ func (e *BaseError) Error() string

+ func (e *BaseError) IsRetryable() bool

+ func (e *BaseError) Metadata() map[string]interface{}

+ func (e *BaseError) Severity() Severity

+ func (e *BaseError) Stack() []StackFrame

+ func (e *BaseError) StackTrace() string

+ func (e *BaseError) Unwrap() error

+ func (e *BaseError) UserMessage() string

+ func (e *BaseError) WithMetadata(key string, value interface{}) *BaseError

+ type CircuitBreaker struct

+ func NewCircuitBreaker(maxFailures int, resetTimeout time.Duration) *CircuitBreaker

+ func (cb *CircuitBreaker) Execute(fn func() error) error

+ func (cb *CircuitBreaker) GetState() CircuitState

+ func (cb *CircuitBreaker) Reset()

+ type CircuitState int

+ const StateClosed

+ const StateHalfOpen

+ const StateOpen

+ type ConfigError struct

+ ConfigKey string

+ ConfigPath string

+ func NewConfigError(code ErrorCode, message string, configKey string) *ConfigError

+ func NewConfigInvalidError(configKey, reason string) *ConfigError

+ func NewConfigMissingError(configKey string) *ConfigError

+ func NewConfigParseError(configPath string, cause error) *ConfigError

+ func NewConfigValidationError(configKey, validationRule string) *ConfigError

+ func (e *ConfigError) WithPath(path string) *ConfigError

+ type DatabaseError struct

+ Constraint string

+ Operation string

+ Query string

+ Table string

+ func NewDBConnectionError(dbName string, cause error) *DatabaseError

+ func NewDBConstraintError(table, constraint string, cause error) *DatabaseError

+ func NewDBDuplicateError(table, field, value string) *DatabaseError

+ func NewDBNotFoundError(table, identifier string) *DatabaseError

+ func NewDBQueryError(operation, table string, cause error) *DatabaseError

+ func NewDBTransactionError(operation string, cause error) *DatabaseError

+ func NewDatabaseError(code ErrorCode, message string) *DatabaseError

+ func (e *DatabaseError) WithConstraint(constraint string) *DatabaseError

+ func (e *DatabaseError) WithOperation(operation string) *DatabaseError

+ func (e *DatabaseError) WithQuery(query string) *DatabaseError

+ func (e *DatabaseError) WithTable(table string) *DatabaseError

+ type ErrorCode string

+ const ErrCodeAuthExpiredToken

+ const ErrCodeAuthFailed

+ const ErrCodeAuthInvalidCredentials

+ const ErrCodeAuthInvalidToken

+ const ErrCodeAuthPermissionDenied

+ const ErrCodeConfigInvalid

+ const ErrCodeConfigMissing

+ const ErrCodeConfigParse

+ const ErrCodeConfigValidation

+ const ErrCodeDBConnection

+ const ErrCodeDBConstraint

+ const ErrCodeDBDuplicate

+ const ErrCodeDBNotFound

+ const ErrCodeDBQuery

+ const ErrCodeDBTransaction

+ const ErrCodeProviderInvalidResponse

+ const ErrCodeProviderNotFound

+ const ErrCodeProviderRateLimit

+ const ErrCodeProviderTimeout

+ const ErrCodeProviderUnavailable

+ const ErrCodeSecurityDecryption

+ const ErrCodeSecurityEncryption

+ const ErrCodeSecurityInvalidKey

+ const ErrCodeSecurityViolation

+ const ErrCodeToolExecutionFailed

+ const ErrCodeToolInvalidInput

+ const ErrCodeToolNotFound

+ const ErrCodeToolPermissionDenied

+ const ErrCodeToolTimeout

+ func GetCode(err error) ErrorCode

+ type ErrorResponse struct

+ Code string

+ Message string

+ Metadata map[string]interface{}

+ Retryable bool

+ Severity string

+ Stack []StackFrame

+ UserMsg string

+ type ErrorSummary struct

+ Code string

+ HasCause bool

+ Message string

+ Retryable bool

+ Severity string

+ StackSize int

+ func Summarize(err error) ErrorSummary

+ type ExponentialBackoff struct

+ InitialDelay time.Duration

+ MaxDelay time.Duration

+ MaxRetries int

+ Multiplier float64

+ func NewExponentialBackoff() *ExponentialBackoff

+ func (e *ExponentialBackoff) GetDelay(attempt int) time.Duration

+ func (e *ExponentialBackoff) MaxAttempts() int

+ func (e *ExponentialBackoff) ShouldRetry(err error, attempt int) bool

+ type LinearBackoff struct

+ Delay time.Duration

+ MaxRetries int

+ func NewLinearBackoff(delay time.Duration, maxRetries int) *LinearBackoff

+ func (l *LinearBackoff) GetDelay(attempt int) time.Duration

+ func (l *LinearBackoff) MaxAttempts() int

+ func (l *LinearBackoff) ShouldRetry(err error, attempt int) bool

+ type ProviderError struct

+ Model string

+ ProviderName string

+ RequestID string

+ RetryAfter *time.Duration

+ StatusCode int

+ func NewProviderError(code ErrorCode, message string, providerName string) *ProviderError

+ func NewProviderInvalidResponseError(providerName string, reason string, cause error) *ProviderError

+ func NewProviderNotFoundError(providerName string) *ProviderError

+ func NewProviderRateLimitError(providerName string, retryAfter time.Duration) *ProviderError

+ func NewProviderTimeoutError(providerName, model string, timeout time.Duration) *ProviderError

+ func NewProviderUnavailableError(providerName string, cause error) *ProviderError

+ func (e *ProviderError) GetRetryDelay() time.Duration

+ func (e *ProviderError) ShouldRetry() bool

+ func (e *ProviderError) WithModel(model string) *ProviderError

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

+ func (e *ProviderError) WithStatusCode(statusCode int) *ProviderError

+ type ProviderRecoveryStrategy struct

+ EnableJitter bool

+ InitialBackoff time.Duration

+ Logger func(message string)

+ MaxBackoff time.Duration

+ MaxRetries int

+ Multiplier float64

+ OnAPIKeyResolution func(ctx context.Context) (string, error)

+ OnTimeoutIncrease func(currentTimeout time.Duration) time.Duration

+ OnTokenReduction func(currentTokens int) int

+ func NewProviderRecoveryStrategy() *ProviderRecoveryStrategy

+ func (p *ProviderRecoveryStrategy) AnalyzeError(ctx context.Context, err error, attempt int, statusCode int, ...) RecoveryDecision

+ func (p *ProviderRecoveryStrategy) ExecuteWithRecovery(ctx context.Context, fn func(ctx context.Context) error, ...) error

+ type RecoveryAction int

+ const ActionCircuitBreak

+ const ActionFail

+ const ActionIncreaseTimeout

+ const ActionReduceTokens

+ const ActionResolveAPIKey

+ const ActionRetry

+ const ActionRetryWithBackoff

+ type RecoveryDecision struct

+ Action RecoveryAction

+ Message string

+ NewAPIKey string

+ NewTimeout time.Duration

+ RetryAfter time.Duration

+ ShouldRetry bool

+ TokenReduction int

+ type RetryConfig struct

+ OnFinalError func(err error)

+ OnRetry func(attempt int, err error)

+ Strategy RetryStrategy

+ func NewRetryConfig() *RetryConfig

+ type RetryStrategy interface

+ GetDelay func(attempt int) time.Duration

+ MaxAttempts func() int

+ ShouldRetry func(err error, attempt int) bool

+ type SecurityError struct

+ Action string

+ Resource string

+ func NewDecryptionError(reason string) *SecurityError

+ func NewEncryptionError(reason string) *SecurityError

+ func NewInvalidKeyError(keyType, reason string) *SecurityError

+ func NewSecurityError(code ErrorCode, message string, resource string) *SecurityError

+ func NewSecurityViolationError(resource, action, reason string) *SecurityError

+ func (e *SecurityError) WithAction(action string) *SecurityError

+ type Severity string

+ const SeverityCritical

+ const SeverityHigh

+ const SeverityLow

+ const SeverityMedium

+ func GetSeverity(err error) Severity

+ type StackFrame struct

+ File string

+ Function string

+ Line int

+ type ToolExecutionError struct

+ ExitCode int

+ Output string

+ Parameters map[string]interface{}

+ ToolName string

+ ToolPath string

+ func NewToolExecutionError(code ErrorCode, message string, toolName string) *ToolExecutionError

+ func NewToolExecutionFailedError(toolName string, exitCode int, output string, cause error) *ToolExecutionError

+ func NewToolInvalidInputError(toolName, paramName, reason string) *ToolExecutionError

+ func NewToolNotFoundError(toolName string) *ToolExecutionError

+ func NewToolPermissionDeniedError(toolName, resource string) *ToolExecutionError

+ func NewToolTimeoutError(toolName string, timeout time.Duration) *ToolExecutionError

+ func (e *ToolExecutionError) GetOutput(maxLength int) string

+ func (e *ToolExecutionError) WithExitCode(exitCode int) *ToolExecutionError

+ func (e *ToolExecutionError) WithOutput(output string) *ToolExecutionError

+ func (e *ToolExecutionError) WithParameter(name string, value interface{}) *ToolExecutionError

+ func (e *ToolExecutionError) WithPath(path string) *ToolExecutionError