GeezerVison

The CDPSession instances are used to talk raw Chrome Devtools Protocol:

• protocol methods can be called with session.send method.
• protocol events can be subscribed to with session.on method.

Useful links:

• Documentation on DevTools Protocol can be found here: DevTools Protocol Viewer.
• Getting Started with DevTools Protocol: https://github.com/aslushnikov/getting-started-with-cdp/blob/master/README.md

client = page.context.new_cdp_session(page)
client.send("Animation.enable")
client.on("Animation.animationCreated", lambda: print("animation created!"))
response = client.send("Animation.getPlaybackRate")
print("playback rate is " + str(response["playbackRate"]))
client.send("Animation.setPlaybackRate", {
    "playbackRate": response["playbackRate"] / 2
})

client = await page.context.new_cdp_session(page)
await client.send("Animation.enable")
client.on("Animation.animationCreated", lambda: print("animation created!"))
response = await client.send("Animation.getPlaybackRate")
print("playback rate is " + str(response["playbackRate"]))
await client.send("Animation.setPlaybackRate", {
    "playbackRate": response["playbackRate"] / 2
})

Methods​

detach​

Detaches the CDPSession from the target. Once detached, the CDPSession object won't emit any events and can't be used to send messages.

Usage

cdp_session.detach()

Returns

• NoneType#

send​

Usage

cdp_session.send(method)
cdp_session.send(method, **kwargs)

Arguments

• method str#

  Protocol method name.

• params Dict (optional)#

  Optional method parameters.

• timeout float (optional) Added in: v1.65#

  Maximum time in milliseconds to wait for the response. Defaults to 0 - no timeout.

Returns

• Dict#

Events​

on("close")​

Emitted when the session is closed, either because the target was closed or session.detach() was called.

Usage

cdp_session.on("close", handler)

Event data

• CDPSession