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

failnext

package module

Go to main page

Versions in this module

v1

v1.0.0

Oct 8, 2026

Changes in this version

type Event

+ Duration time.Duration

v0

v0.7.0

Oct 6, 2026

Changes in this version

+ func WithExcludedEndpoints(ctx context.Context, ids ...EndpointID) context.Context

v0.6.0

Sep 25, 2026

Changes in this version

+ var ErrNoUsableEndpoint = errors.New("failnext: no usable endpoint")

+ var ErrUnknownEndpoint = errors.New("failnext: unknown endpoint")

+ func WithFailoverAllowed(ctx context.Context) context.Context

+ func WithFailoverDenied(ctx context.Context) context.Context

+ func WithPreferredEndpoint(ctx context.Context, id EndpointID) context.Context

+ type AttemptError struct

+ Endpoint EndpointID

+ Err error

+ type Config struct

+ AdditionalTriggerStatusCodes []int

+ Base http.RoundTripper

+ Cooldown CooldownConfig

+ Eligible func(EndpointID) bool

+ Endpoints []Endpoint

+ OnEvent func(context.Context, Event)

+ PermissionPolicy func(*http.Request) Permission

+ type CooldownConfig struct

+ Disabled bool

+ Duration time.Duration

+ Threshold int

+ type Endpoint struct

+ ID EndpointID

+ URL string

+ type EndpointID string

+ type Event struct

+ Attempt int

+ Endpoint EndpointID

+ Err error

+ Kind EventKind

+ StatusCode int

+ type EventKind uint8

+ const EventAttempt

+ const EventCooldownSkip

+ const EventReplayError

+ const EventResult

+ type FailoverError struct

+ Attempts []AttemptError

+ func (e *FailoverError) Error() string

+ func (e *FailoverError) Unwrap() error

+ type Permission uint8

+ const PermissionAllow

+ const PermissionDefer

+ const PermissionDeny

+ type Transport struct

+ func New(cfg Config) (*Transport, error)

+ func (t *Transport) CloseIdleConnections()

+ func (t *Transport) RoundTrip(req *http.Request) (*http.Response, error)