React Native CDP Status

Target Domain

Supports additional targets discovery and allows to attach to them.

Methods

Target.activateTarget #

Activates (focuses) the target.

Parameters

targetId

TargetID

Target.attachToTarget #

Attaches to the target with given id.

Parameters

targetId

TargetID

flatten
Optional

boolean

Enables "flat" access to the session via specifying sessionId attribute in the commands. We plan to make this the default, deprecate non-flattened mode, and eventually retire it. See crbug.com/991325.

Return object

sessionId

SessionID

Id assigned to the session.

Target.closeTarget #

Closes the target. If the target is a page that gets closed too.

Parameters

targetId

TargetID

Return object

success

boolean

Always set to true. If an error occurs, the response indicates protocol error.

Deprecated

Target.createBrowserContext #

Creates a new empty BrowserContext. Similar to an incognito profile but you can have more than one.

Parameters

disposeOnDetach
Optional

boolean

If specified, disposes this context when debugging session disconnects.

Experimental

proxyServer
Optional

string

Proxy server, similar to the one passed to --proxy-server

Experimental

proxyBypassList
Optional

string

Proxy bypass list, similar to the one passed to --proxy-bypass-list

Experimental

originsWithUniversalNetworkAccess
Optional

array[ string ]

An optional list of origins to grant unlimited cross-origin access to. Parts of the URL other than those constituting origin are ignored.

Experimental

Return object

browserContextId

Browser.BrowserContextID

The id of the context created.

Target.createTarget #

Creates a new page.

Parameters

url

string

The initial URL the page will be navigated to. An empty string indicates about:blank.

left
Optional

integer

Frame left origin in DIP (requires newWindow to be true or headless shell).

Experimental

top
Optional

integer

Frame top origin in DIP (requires newWindow to be true or headless shell).

Experimental

width
Optional

integer

Frame width in DIP (requires newWindow to be true or headless shell).

height
Optional

integer

Frame height in DIP (requires newWindow to be true or headless shell).

windowState
Optional

WindowState

Frame window state (requires newWindow to be true or headless shell). Default is normal.

browserContextId
Optional

Browser.BrowserContextID

The browser context to create the page in.

Experimental

enableBeginFrameControl
Optional

boolean

Whether BeginFrames for this target will be controlled via DevTools (headless shell only, not supported on MacOS yet, false by default).

Experimental

newWindow
Optional

boolean

Whether to create a new Window or Tab (false by default, not supported by headless shell).

background
Optional

boolean

Whether to create the target in background or foreground (false by default, not supported by headless shell).

forTab
Optional

boolean

Whether to create the target of type "tab".

Experimental

hidden
Optional

boolean

Whether to create a hidden target. The hidden target is observable via protocol, but not present in the tab UI strip. Cannot be created with forTab: true, newWindow: true or background: false. The life-time of the tab is limited to the life-time of the session.

Experimental

Return object

targetId

TargetID

The id of the page opened.

Target.detachFromTarget #

Detaches session with given id.

Parameters

sessionId
Optional

SessionID

Session to detach.

targetId
Optional

TargetID

Deprecated.

Deprecated

Target.disposeBrowserContext #

Deletes a BrowserContext. All the belonging pages will be closed without calling their beforeunload hooks.

Parameters

browserContextId

Browser.BrowserContextID

Target.getBrowserContexts #

Returns all browser contexts created with Target.createBrowserContext method.

Return object

browserContextIds

array[ Browser.BrowserContextID ]

An array of browser context ids.

Target.getTargets #

Retrieves a list of available targets.

Parameters

filter
Optional

TargetFilter

Only targets matching filter will be reported. If filter is not specified and target discovery is currently enabled, a filter used for target discovery is used for consistency.

Experimental

Return object

targetInfos

array[ TargetInfo ]

The list of targets.

Target.setAutoAttach #

Controls whether to automatically attach to new targets which are considered to be directly related to this one (for example, iframes or workers). When turned on, attaches to all existing related targets as well. When turned off, automatically detaches from all currently attached targets. This also clears all targets added by autoAttachRelated from the list of targets to watch for creation of related targets. You might want to call this recursively for auto-attached targets to attach to all available targets.

Parameters

autoAttach

boolean

Whether to auto-attach to related targets.

waitForDebuggerOnStart

boolean

Whether to pause new targets when attaching to them. Use Runtime.runIfWaitingForDebugger to run paused targets.

flatten
Optional

boolean

Experimental

filter
Optional

TargetFilter

Only targets matching filter will be attached.

Experimental

Target.setDiscoverTargets #

Controls whether to discover available targets and notify via targetCreated/targetInfoChanged/targetDestroyed events.

Parameters

discover

boolean

Whether to discover available targets.

filter
Optional

TargetFilter

Only targets matching filter will be attached. If discover is false, filter must be omitted or empty.

Experimental

Events

Target.receivedMessageFromTarget #

Notifies about a new protocol message received from the session (as reported in attachedToTarget event).

Parameters

sessionId

SessionID

Identifier of a session which sends a message.

message

string

targetId
Optional

TargetID

Deprecated.

Deprecated

Target.targetCrashed #

Issued when a target has crashed.

Parameters

targetId

TargetID

status

string

Termination status type.

errorCode

integer

Termination error code.

Target.targetCreated #

Issued when a possible inspection target is created.

Parameters

targetInfo

TargetInfo

Target.targetDestroyed #

Issued when a target is destroyed.

Parameters

targetId

TargetID

Target.targetInfoChanged #

Issued when some information about a target has changed. This only happens between targetCreated and targetDestroyed.

Parameters

targetInfo

TargetInfo

Types

Target.SessionID #

Unique identifier of attached debugging session.

Type: string

Target.TargetID #

Type: string

Target.TargetInfo #

Type: object

Properties

targetId

TargetID

type

string

List of types: https://source.chromium.org/chromium/chromium/src/+/main:content/browser/devtools/devtools_agent_host_impl.cc?ss=chromium&q=f:devtools%20-f:out%20%22::kTypeTab%5B%5D%22

title

string

url

string

attached

boolean

Whether the target has an attached client.

openerId
Optional

TargetID

Opener target Id

canAccessOpener

boolean

Whether the target has access to the originating window.

Experimental

openerFrameId
Optional

Page.FrameId

Frame id of originating window (is only set if target has an opener).

Experimental

parentFrameId
Optional

Page.FrameId

Id of the parent frame, only present for the "iframe" targets.

Experimental

browserContextId
Optional

Browser.BrowserContextIDExperimental

subtype
Optional

string

Provides additional details for specific target types. For example, for the type of "page", this may be set to "prerender".

Experimental