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

errors

package

Go to main page

Versions in this module

v3

v3.1.1

Aug 25, 2026

v3.1.0

Aug 25, 2026

v3.0.0

Aug 12, 2026

Changes in this version

+ var ErrAlreadyExists = stdErrors.New("already exists")

+ var ErrInternal = stdErrors.New("internal error")

+ var ErrInvalidArgument = stdErrors.New("invalid argument")

+ var ErrNotFound = stdErrors.New("not found")

+ var ErrPermissionDenied = stdErrors.New("permission denied")

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

+ var ErrServiceUnavailable = stdErrors.New("service unavailable")

+ var ErrTimeout = stdErrors.New("timeout")

+ var ErrTokenExpired = stdErrors.New("token expired")

+ var ErrTokenInvalid = stdErrors.New("token invalid")

+ var ErrTokenRevoked = stdErrors.New("token revoked")

+ var ErrUnauthorized = stdErrors.New("unauthorized")

+ func GRPCCode(err error) codes.Code

+ func IsAlreadyExists(err error) bool

+ func IsCanceled(err error) bool

+ func IsInternal(err error) bool

+ func IsInvalidArgument(err error) bool

+ func IsNotFound(err error) bool

+ func IsPermissionDenied(err error) bool

+ func IsRateLimited(err error) bool

+ func IsRetryable(err error) bool

+ func IsServiceUnavailable(err error) bool

+ func IsTimeout(err error) bool

+ func IsTokenExpired(err error) bool

+ func IsTokenInvalid(err error) bool

+ func IsUnauthorized(err error) bool

+ func Message(err error) string

+ func ToHTTPStatus(err error) int

+ func Wrap(err error) error

+ func WrapWithCode(err error, code string, message string) error

+ type IAMError struct

+ Cause error

+ Code string

+ GRPCCode codes.Code

+ Message string

+ func AsIAMError(err error) (*IAMError, bool)

+ func (e *IAMError) Error() string

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

+ func (e *IAMError) Unwrap() error

Other modules containing this package

github.com/FangcunMount/iam

github.com/FangcunMount/iam/v2