PyChromeDevTools

To use PyChromeDevTools, you must launch Google Chrome with the remote-debugging-port option enabled. This allows the Python module to communicate with the browser via the Chrome DevTools Protocol.

Run the following command to start Chrome with debugging enabled on port 9222:

google-chrome --remote-debugging-port=9222 --remote-allow-origins=*

Additional Options:

• --enable-benchmarking and --enable-net-benchmarking: Enable advanced Chrome benchmarking capabilities.
• --headless: Run Chrome without a visible user interface.

Install PyChromeDevTools and its required dependencies (requests and websocket-client) using pip:

sudo pip3 install PyChromeDevTools

This example iterates through the messages received during a page load to find Network.responseReceived events and prints the URL of every resource loaded.

import PyChromeDevTools

chrome = PyChromeDevTools.ChromeInterface()
chrome.Network.enable()
chrome.Page.enable()

chrome.Page.navigate(url="http://www.facebook.com")
event, messages = chrome.wait_event("Page.frameStoppedLoading", timeout=60)

for m in messages:
    if "method" in m and m["method"] == "Network.responseReceived":
        try:
            url = m["params"]["response"]["url"]
            print (url)
        except:
            pass

This example enables the Network and Page domains, navigates to a URL, and waits for the Page.loadEventFired event to calculate the total loading time.

import PyChromeDevTools
import time

chrome = PyChromeDevTools.ChromeInterface()
chrome.Network.enable()
chrome.Page.enable()

start_time=time.time()
chrome.Page.navigate(url="http://www.google.com/")
chrome.wait_event("Page.loadEventFired", timeout=60)
end_time=time.time()

print ("Page Loading Time:", end_time-start_time)

This example enables the Network and Page domains, navigates to a site, waits for the frame to stop loading, and then retrieves and prints all cookies.

import PyChromeDevTools
import time

chrome = PyChromeDevTools.ChromeInterface()
chrome.Network.enable()
chrome.Page.enable()

chrome.Page.navigate(url="http://www.nytimes.com/")
chrome.wait_event("Page.frameStoppedLoading", timeout=60)

# Wait last objects to load
time.sleep(5)

cookies, messages = chrome.Network.getCookies()
for cookie in cookies["result"]["cookies"]:
    print ("Cookie:")
    print ("\tDomain:", cookie["domain"])
    print ("\tKey:", cookie["name"])
    print ("\tValue:", cookie["value"])
    print ("\n")

To send a command to Chrome, invoke the corresponding method on the ChromeInterface object. The method names correspond to the Chrome DevTools Protocol domains (e.g., Page.navigate, Network.getCookies).

Commands return a tuple containing:

1. The command's return value (already interpreted as JSON).
2. A list of all messages/events received before the command was run.

return_value, messages = chrome.Page.navigate(url="http://example.com/")

Create a ChromeInterface object to establish a connection to the running Chrome instance. By default, it connects to localhost:9222.

Custom Host and Port: You can specify a different host and port manually:

chrome = PyChromeDevTools.ChromeInterface(host="1.1.1.1", port=1234)

Android Support: When working in Android environments, set suppress_origin=True to suppress the Origin Header in the created websockets:

chrome = PyChromeDevTools.ChromeInterface(suppress_origin=True)

Direct Target Connection: To bypass querying the JSON for a tab ID and connect directly to a specific target, use connect_targetID:

chrome.connect_targetID(targetID="YOUR_TARGET_ID")

chrome = PyChromeDevTools.ChromeInterface()