httputil

Documentation

Index

• func DumpRequest(req *http.Request, body bool) ([]byte, error)
• func DumpRequestJSON(req *http.Request, body bool, ...) (style.Info, error)
• func DumpRequestOut(req *http.Request, body bool) ([]byte, error)
• func DumpResponse(resp *http.Response, body bool) ([]byte, error)
• func DumpResponseJSON(resp *http.Response, body bool, ...) (style.Info, error)

Functions

func DumpRequest

func DumpRequest(req *http.Request, body bool) ([]byte, error)

DumpRequest returns the given request in its HTTP/1.x wire representation. It should only be used by servers to debug client requests. The returned representation is an approximation only; some details of the initial request are lost while parsing it into an http.Request. In particular, the order and case of header field names are lost. The order of values in multi-valued headers is kept intact. HTTP/2 requests are dumped in HTTP/1.x form, not in their original binary representations.

If body is true, DumpRequest also returns the body. To do so, it consumes req.Body and then replaces it with a new io.ReadCloser that yields the same bytes. If DumpRequest returns an error, the state of req is undefined.

The documentation for http.Request.Write details which fields of req are included in the dump.

func DumpRequestJSON

func DumpRequestJSON(
	req *http.Request,
	body bool,
	extractInfo func(*http.Request) (style.Info, error),
) (style.Info, error)

func DumpRequestOut

func DumpRequestOut(req *http.Request, body bool) ([]byte, error)

DumpRequestOut is like DumpRequest but for outgoing client requests. It includes any headers that the standard http.Transport adds, such as User-Agent.

func DumpResponse

func DumpResponse(resp *http.Response, body bool) ([]byte, error)

DumpResponse is like DumpRequest but dumps a response.

func DumpResponseJSON

func DumpResponseJSON(
	resp *http.Response,
	body bool,
	extractInfo func(*http.Response) (style.Info, error),
) (style.Info, error)