pychrome

A Python Package for the Google Chrome Dev Protocol, more document

Table of Contents

• Installation
• Setup Chrome
• Getting Started
• Tab management
• Debug
• Examples
• Ref

Installation

To install pychrome, simply:

$ pip install -U pychrome

or from GitHub:

$ pip install -U git+https://github.com/fate0/pychrome.git

or from source:

$ python setup.py install

Setup Chrome

simply:

$ google-chrome --remote-debugging-port=9222

or headless mode (chrome version >= 59):

$ google-chrome --headless --disable-gpu --remote-debugging-port=9222

or use docker:

$ docker pull fate0/headless-chrome
$ docker run -it --rm --cap-add=SYS_ADMIN -p9222:9222 fate0/headless-chrome

Getting Started

importpychrome# create a browser instancebrowser=pychrome.Browser(url="http://127.0.0.1:9222")
# create a tabtab=browser.new_tab()
# register callback if you wantdefrequest_will_be_sent(**kwargs):
print("loading: %s"%kwargs.get('request').get('url'))
tab.Network.requestWillBeSent=request_will_be_sent# start the tab tab.start()
# call methodtab.Network.enable()
# call method with timeouttab.Page.navigate(url="https://github.com/fate0/pychrome", _timeout=5)
# wait for loadingtab.wait(5)
# stop the tab (stop handle events and stop recv message from chrome)tab.stop()
# close tabbrowser.close_tab(tab)

or (alternate syntax)

importpychromebrowser=pychrome.Browser(url="http://127.0.0.1:9222")
tab=browser.new_tab()
defrequest_will_be_sent(**kwargs):
print("loading: %s"%kwargs.get('request').get('url'))
tab.set_listener("Network.requestWillBeSent", request_will_be_sent)
tab.start()
tab.call_method("Network.enable")
tab.call_method("Page.navigate", url="https://github.com/fate0/pychrome", _timeout=5)
tab.wait(5)
tab.stop()
browser.close_tab(tab)

more methods or events could be found in Chrome DevTools Protocol

Debug

set DEBUG env variable:

Tab management

run pychrome -h for more info

example:

Examples

please see the examples directory for more examples

Ref

• chrome-remote-interface
• Chrome DevTools Protocol