Package io.webfolder.cdp.command

Interface Target

public interface Target

Supports additional targets discovery and allows to attach to them

Method Summary

Modifier and Type	Method	Description
void	activateTarget(String targetId)	Activates (focuses) the target.
String	attachToTarget(String targetId)	Attaches to the target with given id.
Boolean	closeTarget(String targetId)	Closes the target.
String	createBrowserContext()	Creates a new empty BrowserContext.
String	createTarget(String url)	Creates a new page.
String	createTarget(String url, Integer width, Integer height, String browserContextId, Boolean enableBeginFrameControl)	Creates a new page.
void	detachFromTarget()	Detaches session with given id.
void	detachFromTarget(String sessionId, String targetId)	Detaches session with given id.
Boolean	disposeBrowserContext(String browserContextId)	Deletes a BrowserContext, will fail of any open page uses it.
TargetInfo	getTargetInfo(String targetId)	Returns information about a target.
List<TargetInfo>	getTargets()	Retrieves a list of available targets.
void	sendMessageToTarget(String message)	Sends protocol message over session with given id.
void	sendMessageToTarget(String message, String sessionId, String targetId)	Sends protocol message over session with given id.
void	setAttachToFrames(Boolean value)
void	setAutoAttach(Boolean autoAttach, Boolean waitForDebuggerOnStart)	Controls whether to automatically attach to new targets which are considered to be related to this one.
void	setDiscoverTargets(Boolean discover)	Controls whether to discover available targets and notify via `targetCreated/targetInfoChanged/targetDestroyed` events.
void	setRemoteLocations(List<RemoteLocation> locations)	Enables target discovery for the specified locations, when setDiscoverTargets was set to true.

Method Detail

activateTarget

void activateTarget(String targetId)

Activates (focuses) the target.

attachToTarget

String attachToTarget(String targetId)

Attaches to the target with given id.

Returns:

Id assigned to the session.

closeTarget

Boolean closeTarget(String targetId)

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

createBrowserContext

String createBrowserContext()

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

Returns:

The id of the context created.

createTarget

String createTarget(String url,
                    Integer width,
                    Integer height,
                    String browserContextId,
                    Boolean enableBeginFrameControl)

Creates a new page.

Parameters:

url - The initial URL the page will be navigated to.

width - Frame width in DIP (headless chrome only).

height - Frame height in DIP (headless chrome only).

browserContextId - The browser context to create the page in (headless chrome only).

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

Returns:

The id of the page opened.

detachFromTarget

void detachFromTarget(String sessionId,
                      String targetId)

Detaches session with given id.

Parameters:

sessionId - Session to detach.

targetId - Deprecated.

disposeBrowserContext

Boolean disposeBrowserContext(String browserContextId)

Deletes a BrowserContext, will fail of any open page uses it.

getTargetInfo

TargetInfo getTargetInfo(String targetId)

Returns information about a target.

getTargets

List<TargetInfo> getTargets()

Retrieves a list of available targets.

Returns:

The list of targets.

sendMessageToTarget

void sendMessageToTarget(String message,
                         String sessionId,
                         String targetId)

Sends protocol message over session with given id.

Parameters:

sessionId - Identifier of the session.

targetId - Deprecated.

setAttachToFrames

void setAttachToFrames(Boolean value)

setAutoAttach

void setAutoAttach(Boolean autoAttach,
                   Boolean waitForDebuggerOnStart)

Controls whether to automatically attach to new targets which are considered to be related to this one. When turned on, attaches to all existing related targets as well. When turned off, automatically detaches from all currently attached targets.

Parameters:

autoAttach - Whether to auto-attach to related targets.

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

setDiscoverTargets

void setDiscoverTargets(Boolean discover)

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

Parameters:

discover - Whether to discover available targets.

setRemoteLocations

void setRemoteLocations(List<RemoteLocation> locations)

Enables target discovery for the specified locations, when setDiscoverTargets was set to true.

Parameters:

locations - List of remote locations.

createTarget

String createTarget(String url)

Creates a new page.

Parameters:

url - The initial URL the page will be navigated to.

Returns:

The id of the page opened.

detachFromTarget

void detachFromTarget()

Detaches session with given id.

sendMessageToTarget

void sendMessageToTarget(String message)

Sends protocol message over session with given id.