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

customhttp

package

Go to main page

Versions in this module

v0

v0.1.7

Jan 5, 2026

Changes in this version

type ClientConfig

+ H3Config H3Settings

+ PaddingStrategy PaddingStrategy

type H2Client

+ func (c *H2Client) PrepareRequest(ctx context.Context, req *http.Request) (*H2StreamHandle, error)

+ func (c *H2Client) ReleaseBody(handle *H2StreamHandle) error

+ func (c *H2Client) WaitResponse(ctx context.Context, handle *H2StreamHandle) (*http.Response, error)

+ type H2StreamHandle struct

+ type H3Client struct

+ Config *ClientConfig

+ Logger *zap.Logger

+ TargetURL *url.URL

+ func NewH3Client(targetURL *url.URL, config *ClientConfig, logger *zap.Logger) (*H3Client, error)

+ func (c *H3Client) Close() error

+ func (c *H3Client) Connect(ctx context.Context) error

+ func (c *H3Client) Do(ctx context.Context, req *http.Request) (*http.Response, error)

+ func (c *H3Client) IsIdle(timeout time.Duration) bool

+ type H3Settings struct

+ KeepAlivePeriod time.Duration

+ MaxIdleTimeout time.Duration

+ func DefaultH3Settings() H3Settings

+ type PaddingStrategy interface

+ CalculatePadding func(req *http.Request, frameType http2.FrameType, payloadLen int) uint8

v0.1.6

Jan 1, 2026

Changes in this version

+ const DefaultH2InitialWindowSize

+ const DefaultH2MaxFrameSize

+ const MaxReplayableBodyBytes

+ const MaxResponseBodyBytes

+ const TargetH2ConnWindowSize

+ const TargetH2StreamWindowSize

+ var ErrCredentialsNotFound = errors.New("credentials not found")

+ func SerializeRequest(req *http.Request) ([]byte, error)

+ type ClientConfig struct

+ CheckRedirect func(req *http.Request, via []*http.Request) error

+ CookieJar http.CookieJar

+ CredentialsProvider CredentialsProvider

+ DialerConfig *network.DialerConfig

+ H2Config H2Settings

+ IdleConnTimeout time.Duration

+ InsecureSkipVerify bool

+ RequestTimeout time.Duration

+ RetryPolicy *RetryPolicy

+ func NewBrowserClientConfig() *ClientConfig

+ func (c *ClientConfig) SetProxy(proxyURL *url.URL)

+ type ConnectionPool interface

+ Close func() error

+ IsIdle func(timeout time.Duration) bool

+ type CredentialsProvider interface

+ GetCredentials func(host string, realm string) (username string, password string, err error)

+ type CustomClient struct

+ Config *ClientConfig

+ Logger *zap.Logger

+ MaxRedirects int

+ func NewCustomClient(config *ClientConfig, logger *zap.Logger) *CustomClient

+ func (c *CustomClient) CloseAll()

+ func (c *CustomClient) ConnectionCount() int

+ func (c *CustomClient) Do(ctx context.Context, req *http.Request) (*http.Response, error)

+ type H1Client struct

+ Address string

+ Config *ClientConfig

+ Conn net.Conn

+ Logger *zap.Logger

+ TargetURL *url.URL

+ func NewH1Client(targetURL *url.URL, config *ClientConfig, logger *zap.Logger) (*H1Client, error)

+ func (c *H1Client) Close() error

+ func (c *H1Client) Connect(ctx context.Context) error

+ func (c *H1Client) Do(ctx context.Context, req *http.Request) (*http.Response, error)

+ func (c *H1Client) IsIdle(timeout time.Duration) bool

+ func (c *H1Client) ReadPipelinedResponses(ctx context.Context, expectedCount int) ([]*http.Response, error)

+ func (c *H1Client) SendRaw(ctx context.Context, data []byte) error

+ type H2Client struct

+ Address string

+ Config *ClientConfig

+ Conn net.Conn

+ Framer *http2.Framer

+ HPDecoder *hpack.Decoder

+ HPEncoder *hpack.Encoder

+ Logger *zap.Logger

+ TargetURL *url.URL

+ func NewH2Client(targetURL *url.URL, config *ClientConfig, logger *zap.Logger) (*H2Client, error)

+ func (c *H2Client) Close() error

+ func (c *H2Client) Connect(ctx context.Context) error

+ func (c *H2Client) Do(ctx context.Context, req *http.Request) (*http.Response, error)

+ func (c *H2Client) IsIdle(timeout time.Duration) bool

+ type H2Settings struct

+ PingInterval time.Duration

+ PingTimeout time.Duration

+ func DefaultH2Settings() H2Settings

+ type H2StreamResetError struct

+ ErrCode http2.ErrCode

+ func (e H2StreamResetError) Error() string

+ type RetryPolicy struct

+ BackoffFactor float64

+ InitialBackoff time.Duration

+ Jitter bool

+ MaxBackoff time.Duration

+ MaxRetries int

+ RetryableStatusCodes map[int]bool

+ func NewDefaultRetryPolicy() *RetryPolicy