chromedp/README.md

48 lines
1.8 KiB
Markdown
Raw Normal View History

2017-12-27 02:30:28 +00:00
# About chromedp [![Build Status][1]][2] [![Coverage Status][3]][4]
2017-01-24 15:09:23 +00:00
2018-07-13 05:46:30 +00:00
Package chromedp is a faster, simpler way to drive browsers supporting the
[Chrome DevTools Protocol][5] in Go using the without external dependencies
(ie, Selenium, PhantomJS, etc).
2017-01-24 15:09:23 +00:00
2017-12-27 02:30:28 +00:00
## Installing
2017-01-24 15:09:23 +00:00
2018-07-13 05:46:30 +00:00
Install in the usual Go way:
2017-01-24 15:09:23 +00:00
```sh
2017-12-27 02:30:28 +00:00
go get -u github.com/chromedp/chromedp
2017-01-24 15:09:23 +00:00
```
2018-07-13 05:46:30 +00:00
## Examples
2017-01-24 15:38:56 +00:00
2017-12-27 02:30:28 +00:00
Please see the [examples][6] project for more examples. Please refer to the
[GoDoc API listing][7] for a summary of the API and Actions, which also contains
a few simple and runnable examples.
2017-01-24 15:09:23 +00:00
2017-12-27 02:30:28 +00:00
## Resources
2017-12-28 04:38:11 +00:00
* [chromedp: A New Way to Drive the Web][8] - GopherCon SG 2017 talk
2018-07-13 05:46:30 +00:00
* [Chrome DevTools Protocol][5] - Chrome DevTools Protocol Domain documentation
2017-12-27 02:30:28 +00:00
* [chromedp examples][6] - various `chromedp` examples
2017-12-28 04:38:11 +00:00
* [`github.com/chromedp/cdproto`][9] - GoDoc listing for the CDP domains used by `chromedp`
2018-02-16 00:23:02 +00:00
* [`github.com/chromedp/cdproto-gen`][10] - tool used to generate `cdproto`
2018-07-13 05:46:30 +00:00
* [`github.com/chromedp/chromedp-proxy`][11] - a simple CDP proxy for logging CDP clients and browsers
2017-01-24 15:09:23 +00:00
## TODO
2017-12-27 02:30:28 +00:00
2017-01-24 15:09:23 +00:00
* Implement more query selector options (allow over riding context timeouts)
* Contextual actions for "dry run" (or via an accumulator?)
* Network loader / manager
* Profiler
2017-12-27 02:30:28 +00:00
[1]: https://travis-ci.org/chromedp/chromedp.svg
[2]: https://travis-ci.org/chromedp/chromedp
[3]: https://coveralls.io/repos/chromedp/chromedp/badge.svg?branch=master&service=github
[4]: https://coveralls.io/github/chromedp/chromedp?branch=master
[5]: https://chromedevtools.github.io/devtools-protocol/
[6]: https://github.com/chromedp/examples
[7]: https://godoc.org/github.com/chromedp/chromedp
[8]: https://www.youtube.com/watch?v=_7pWCg94sKw
2017-12-28 04:38:11 +00:00
[9]: https://godoc.org/github.com/chromedp/cdproto
2018-02-16 00:23:02 +00:00
[10]: https://github.com/chromedp/cdproto-gen
2017-12-28 04:38:11 +00:00
[11]: https://github.com/chromedp/chromedp-proxy