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 and Description
void	activateTarget(String targetId) Activates (focuses) the target.
Boolean	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) Creates a new page.
void	detachFromTarget(String targetId) Detaches from the target 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 targetId, String message) Sends protocol message to the target 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/targetDestroyed events.
void	setRemoteLocations(List<RemoteLocation> locations) Enables target discovery for the specified locations, when setDiscoverTargets was set to true.

Method Detail

setDiscoverTargets

void setDiscoverTargets(Boolean discover)

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

Parameters:

discover - Whether to discover available targets.

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.

setAttachToFrames

void setAttachToFrames(Boolean value)

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.

sendMessageToTarget

void sendMessageToTarget(String targetId,
                         String message)

Sends protocol message to the target with given id.

getTargetInfo

TargetInfo getTargetInfo(String targetId)

Returns information about a target.

activateTarget

void activateTarget(String targetId)

Activates (focuses) the target.

closeTarget

Boolean closeTarget(String targetId)

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

attachToTarget

Boolean attachToTarget(String targetId)

Attaches to the target with given id.

Returns:

Whether attach succeeded.

detachFromTarget

void detachFromTarget(String targetId)

Detaches from the target with given id.

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.

disposeBrowserContext

Boolean disposeBrowserContext(String browserContextId)

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

createTarget

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

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).

Returns:

The id of the page opened.

getTargets

List<TargetInfo> getTargets()

Retrieves a list of available targets.

Returns:

The list of targets.

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.