fetch

Documentation

Index

• type Client
  • func NewClient(opts ...ClientOption) *Client
  • func (c *Client) Do(req *Request, init *RequestInit) (*http.Response, error)
  • func (c *Client) HTTPClient(redirect RedirectMode) *http.Client
• type ClientOption
  • func WithBinding(bind js.Value) ClientOption
• type IncomingBotManagement
  • func NewIncomingBotManagement(cf js.Value) *IncomingBotManagement
• type IncomingBotManagementJsDetection
  • func NewIncomingBotManagementJsDetection(cf js.Value) *IncomingBotManagementJsDetection
• type IncomingProperties
  • func NewIncomingProperties(ctx context.Context) (*IncomingProperties, error)
• type IncomingTLSClientAuth
  • func NewIncomingTLSClientAuth(cf js.Value) *IncomingTLSClientAuth
• type IncomingTLSExportedAuthenticator
  • func NewIncomingTLSExportedAuthenticator(cf js.Value) *IncomingTLSExportedAuthenticator
• type RedirectMode
  • func (mode RedirectMode) IsValid() bool
  • func (mode RedirectMode) String() string
• type Request
  • func NewRequest(ctx context.Context, method string, url string, body io.Reader) (*Request, error)
• type RequestInit
  • func (init *RequestInit) ToJS() js.Value
• type RequestInitCF

Types

type Client

type Client struct {
	// contains filtered or unexported fields
}

Client is an HTTP client.

func NewClient

func NewClient(opts ...ClientOption) *Client

NewClient returns new Client

func (*Client) Do

func (c *Client) Do(req *Request, init *RequestInit) (*http.Response, error)

Do sends an HTTP request and returns an HTTP response

func (*Client) HTTPClient

func (c *Client) HTTPClient(redirect RedirectMode) *http.Client

HTTPClient returns *http.Client.

type ClientOption

type ClientOption func(*Client)

ClientOption is a type that represents an optional function.

func WithBinding

func WithBinding(bind js.Value) ClientOption

WithBinding changes the objects that Fetch API belongs to. This is useful for service bindings, mTLS, etc.

type IncomingBotManagement

type IncomingBotManagement struct {
	CorporateProxy bool
	VerifiedBot    bool
	JsDetection    *IncomingBotManagementJsDetection
	StaticResource bool
	Score          int
}

func NewIncomingBotManagement

func NewIncomingBotManagement(cf js.Value) *IncomingBotManagement

type IncomingBotManagementJsDetection

type IncomingBotManagementJsDetection struct {
	Passed bool
}

func NewIncomingBotManagementJsDetection

func NewIncomingBotManagementJsDetection(cf js.Value) *IncomingBotManagementJsDetection

type IncomingProperties

type IncomingProperties struct {
	Longitude                string
	Latitude                 string
	TLSCipher                string
	Continent                string
	Asn                      int
	ClientAcceptEncoding     string
	Country                  string
	TLSClientAuth            *IncomingTLSClientAuth
	TLSExportedAuthenticator *IncomingTLSExportedAuthenticator
	TLSVersion               string
	Colo                     string
	Timezone                 string
	City                     string
	VerifiedBotCategory      string
	// EdgeRequestKeepAliveStatus int
	RequestPriority string
	HttpProtocol    string
	Region          string
	RegionCode      string
	AsOrganization  string
	PostalCode      string
	BotManagement   *IncomingBotManagement
}

func NewIncomingProperties

func NewIncomingProperties(ctx context.Context) (*IncomingProperties, error)

type IncomingTLSClientAuth

type IncomingTLSClientAuth struct {
	CertIssuerDNLegacy    string
	CertIssuerSKI         string
	CertSubjectDNRFC2253  string
	CertSubjectDNLegacy   string
	CertFingerprintSHA256 string
	CertNotBefore         string
	CertSKI               string
	CertSerial            string
	CertIssuerDN          string
	CertVerified          string
	CertNotAfter          string
	CertSubjectDN         string
	CertPresented         string
	CertRevoked           string
	CertIssuerSerial      string
	CertIssuerDNRFC2253   string
	CertFingerprintSHA1   string
}

func NewIncomingTLSClientAuth

func NewIncomingTLSClientAuth(cf js.Value) *IncomingTLSClientAuth

type IncomingTLSExportedAuthenticator

type IncomingTLSExportedAuthenticator struct {
	ClientFinished  string
	ClientHandshake string
	ServerHandshake string
	ServerFinished  string
}

func NewIncomingTLSExportedAuthenticator

func NewIncomingTLSExportedAuthenticator(cf js.Value) *IncomingTLSExportedAuthenticator

type RedirectMode

type RedirectMode string

RedirectMode represents the redirect mode of a fetch() request.

var (
	RedirectModeFollow RedirectMode = "follow"
	RedirectModeError  RedirectMode = "error"
	RedirectModeManual RedirectMode = "manual"
)

func (RedirectMode) IsValid

func (mode RedirectMode) IsValid() bool

func (RedirectMode) String

func (mode RedirectMode) String() string

type Request

type Request struct {
	*http.Request
}

Request represents an HTTP request and is part of the Fetch API. Docs: https://developers.cloudflare.com/workers/runtime-apis/request/

func NewRequest

func NewRequest(ctx context.Context, method string, url string, body io.Reader) (*Request, error)

NewRequest returns new Request given a method, URL, and optional body

type RequestInit

type RequestInit struct {
	CF       *RequestInitCF
	Redirect RedirectMode
}

RequestInit represents the options passed to a fetch() request.

func (*RequestInit) ToJS

func (init *RequestInit) ToJS() js.Value

ToJS converts RequestInit to JS object.

type RequestInitCF

type RequestInitCF struct {
}

RequestInitCF represents the Cloudflare-specific options passed to a fetch() request.