About chromedp examples

This folder contains a variety of code examples for working with chromedp. The package documentation contains a number of simple examples which are self-contained, while this repository holds more complex examples which tend to require internet access or external components.

Please note that these examples may break occassionally. Additionally, since these examples are written for specific websites, there is a good chance that the current selectors, etc. break after the website they are written against changes.

While every effort is made to ensure that these examples are kept up-to-date, it is expected that the examples made available here may occasionally break.

To file issues, use the chromedp's issue tracker.

Building and Running an Example

You can build and run these examples in the usual Go way:

# retrieve examples
$ go get -u -d github.com/chromedp/examples

# run example <prog>
$ go run $GOPATH/src/github.com/chromedp/examples/<prog>/main.go

# build example <prog>
$ go build -o <prog> github.com/chromedp/examples/<prog> && ./<prog>

Available Examples

The following examples are currently available:

Example	Description
click	use a selector to click on an element
cookie	set a HTTP cookie on requests
download_file	do headless file downloads
download_image	do headless image downloads
emulate	emulate a specific device such as an iPhone
eval	evaluate javascript and retrieve the result
fast	extract and render data from a page
forecast	extract and render data from a page
geoip	extract and render data from a page
headers	add extra HTTP headers to browser requests
keys	send key events to an element
latlon	retrieve the latitude/longitude from google maps, using the browser's target events
logic	more complex logic beyond simple actions
multi	use headless-shell and a container (Docker, Podman, other)
pdf	capture a pdf of a page
proxy	authenticate a proxy server which requires authentication
remote	connect to an existing Chrome DevTools instance using a remote WebSocket URL
screenshot	take a screenshot of a specific element and of the entire browser viewport
submit	fill out and submit a form
subtree	populate and travel a subtree of the DOM
text	extract text from a specific element
upload	upload a file on a form
visible	wait until an element is visible

Contributing

Pull Requests and contributions to this project are encouraged and greatly welcomed! The chromedp project always needs new examples, and needs talented developers (such as yourself!) to submit fixes for the existing examples when they break (for example, when a website's layout/HTML changes).