retracer

README

retracer: URL Redirect Tracer

h12.io/retracer is a Go package that can trace any HTTP(S) URL redirections regardless they are 3xx redirections, http-eqiv refreshes, Javascript navigations and the non-standard HTTP Refresh header.

Features

• Cookie, Referer and custom headers supported
• Avoid unnecessary resource loading, like: CSS, images and iframes

Install

sudo apt-get install surf xvfb
go get h12.io/retracer

Tips

It is recommended to use Xvfb to prevent Surf window appearing during Javascript tracing.

xvfb :99 &
DISPLAY=:99 ./your_program

To build Surf:

sudo apt-get install libwebkitgtk-dev
make

Documentation

Index

• Variables
• type JSTracer
  • func (t *JSTracer) Trace(uri string, header http.Header, body []byte) (string, error)
• type Tracer
  • func (t *Tracer) Trace(uri string, callback func(string, *http.Response) error) error

Variables

var (
	ErrJSRedirectionTimeout = errors.New("JS redirection timeout")
)

Types

type JSTracer

type JSTracer struct {
	Timeout time.Duration
	Certs   *mitm.CertPool
}

func (*JSTracer) Trace

func (t *JSTracer) Trace(uri string, header http.Header, body []byte) (string, error)

type Tracer

type Tracer struct {
	RoundTripper http.RoundTripper
	Header       http.Header
	Timeout      time.Duration
	Certs        *mitm.CertPool
	Debug        bool
}

func (*Tracer) Trace

func (t *Tracer) Trace(uri string, callback func(string, *http.Response) error) error