Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/integrii/headlesschrome
A Go package for working with headless Chrome. Run interactive JavaScript commands on web pages with Go and Chrome.
https://github.com/integrii/headlesschrome
chrome cli go headless macos package scraper testing
Last synced: 4 days ago
JSON representation
A Go package for working with headless Chrome. Run interactive JavaScript commands on web pages with Go and Chrome.
- Host: GitHub
- URL: https://github.com/integrii/headlesschrome
- Owner: integrii
- License: mit
- Created: 2017-09-24T03:40:23.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2019-02-02T05:29:24.000Z (almost 6 years ago)
- Last Synced: 2024-11-13T06:33:25.752Z (6 days ago)
- Topics: chrome, cli, go, headless, macos, package, scraper, testing
- Language: Go
- Homepage:
- Size: 31.3 KB
- Stars: 120
- Watchers: 8
- Forks: 5
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# DO NOT USE! This project does not work anymore due to changes in Chrome. Use the Chrome DevTools protocol in [chromedp](https://github.com/chromedp) instead!
# headlessChrome 🤖
**Support only for Ubuntu on Docker for now. Mac appears to not be working.** 😬
A [go](https://golang.org) package for working with headless Chrome. Run interactive JavaScript commands on pages with go and Chrome without a GUI. Includes a few helpful functions out of the box to query and click selector paths by their classes, divs, or html content.
You could use this package to click buttons and scrape content on/from a website as if you were a browser, or to render pages that wouldn't be supported by other things like phantomjs or casperjs. Especially useful for sites that use EmberJS, where the content is rendered by javascript after the HTML payload is delivered.
#### Examples
An example project that does some simple things with a `Makefile` and `Dockerfile` is in the examples directory.
#### Install
`go get github.com/integrii/headlessChrome`
#### Documentation
[http://godoc.org/github.com/integrii/headlessChrome](http://godoc.org/github.com/integrii/headlessChrome)
##### Docker Version
To run Chrome headless with docker, check out `examples/docker/main.go` as well as `examples/docker/Makefile`. When in that directory, you can do `make test` to build and run the container with the example app inside. You will see the source of httpbin.org displayed at the end of the build and run.
##### Custom Flags
By default, we startup with the bare minimum flags necessary to start headless chrome and open a javascript console. If you want more flags, like a resolution size, or a custom User-Agent, you can specify it by replacing the `Args` variable. Just be sure to append to it so you don't kill the default flags...
```go
headlessChrome.Args = append(headlessChrome.Args,"--user-agent=Mozilla/5.0 (Macintosh; Intel Mac OS X 10_12_6) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/61.0.3163.100 Safari/537.36")
headlessChrome.Args = append(headlessChrome.Args,"--window-size=1024,768")
```
##### Changing the Path to Chrome
Change the path to Chrome by simply setting the `headlessChrome.ChromePath` variable.
```go
headlessChrome.ChromePath = `/opt/google/chrome-unstable/chrome`
```
##### JavaScript Helper Examples
Find the full list in [the docs](http://godoc.org/github.com/integrii/headlessChrome).
```go
// click some span element from the page by its text content
browser.ClickItemWithInnerHTML("span", "Google Search",0)
// select the content of something by its css classes
browser.GetContentOfItemWithClasses("button arrow bold",0)
time.Sleep(time.Second) // give it a second to query
// read the selected stuff from the console by picking
// the next item from the output channel
fmt.Println(<-browser.Output)
```
#### Contributing
Please send pull requests! It would be good to have support for more operating systems or more handy helpers to run more commonly used javascript code easily. Adding support for other operating systems should be as simple as checking the platform type and changing the `ChromePath` variable's default value.