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

fetch

package

Go to main page

Versions in this module

v1

v1.7.2

Jul 17, 2026

Changes in this version

+ const DefaultMaxJavaScriptRedirectBodySize

+ const DefaultMaxResponseHeaderBytes

type Options

+ MaxJavaScriptRedirectBodySize int64

+ type RedirectError struct

+ Err error

+ Hops []RedirectHop

+ func (e *RedirectError) Error() string

+ func (e *RedirectError) Unwrap() error

+ type RedirectHop struct

+ From string

+ StatusCode int

+ To string

v1.7.1

Jul 15, 2026

v1.7.0

Jul 15, 2026

Changes in this version

+ var ErrFetch = errors.New("fetch failed")

+ var ErrInvalidURL = errors.New("invalid URL")

type Options

+ Retries int

v1.6.21

Jul 15, 2026

v1.6.20

Jul 15, 2026

Changes in this version

type Options

+ HTTPClient *http.Client

+ Transport *http.Transport

v1.6.19

Jul 15, 2026

v1.6.18

Jul 14, 2026

v1.6.17

Jul 14, 2026

Changes in this version

+ const DefaultMaxBodySize

+ const DefaultMaxIconSize

+ const JSExecuteTemplate

+ var DefaultStackDepthLimit = 300

+ func ExtractCharset(htmlContent []byte) string

+ func ExtractContentTypeCharset(contentType string) (charset string)

+ func InsertInto(s string, interval int, sep rune) string

+ func ResponseDecoding(body []byte, label string) string

+ type Banner struct

+ Body string

+ BodyHash int32

+ Cert *tls.ConnectionState

+ Certificate string

+ Charset string

+ Compliance map[string]string

+ Header string

+ Headers map[string]string

+ IconBytes []byte

+ IconHash int32

+ IconType string

+ IconURI string

+ Response string

+ SSL bool

+ StatusCode int

+ Title string

+ Uri string

+ func RequestOnce(client *retryablehttp.Client, uri string, options ...*Options) (banner *Banner, redirectURL string, err error)

+ func (b *Banner) CacheLower()

+ type Fetcher struct

+ func NewFetcher(options *Options) *Fetcher

+ func (c *Fetcher) GetBanner(ctx context.Context, uri string) (*Banner, error)

+ func (c *Fetcher) GetBanners(ctx context.Context, uri string) ([]*Banner, error)

+ func (c *Fetcher) GetClient() *retryablehttp.Client

+ type Options struct

+ DebugReq bool

+ DebugResp bool

+ DisableIcon bool

+ DisableJavaScript bool

+ MaxBodySize int64

+ MaxIconSize int64

+ Proxy string

+ RetryMax int

+ Timeout time.Duration

+ func DefaultOption() *Options