Package org.openqa.selenium.devtools.v135.browser

Class Browser

java.lang.Object

org.openqa.selenium.devtools.v135.browser.Browser

public class Browser
extends Object

The Browser domain defines methods and events for browser managing.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	Browser.GetVersionResponse
static class	Browser.GetWindowForTargetResponse
static enum	Browser.SetDownloadBehaviorBehavior

Constructor Summary

Constructors

Constructor	Description
Browser()

Method Summary

Modifier and Type	Method	Description
static org.openqa.selenium.devtools.Command<Void>	addPrivacySandboxEnrollmentOverride(String url)	Allows a site to use privacy sandbox features that require enrollment without the site actually being enrolled.
static org.openqa.selenium.devtools.Command<Void>	cancelDownload(String guid, Optional<BrowserContextID> browserContextId)	Cancel a download if in progress
static org.openqa.selenium.devtools.Command<Void>	close()	Close browser gracefully.
static org.openqa.selenium.devtools.Command<Void>	crash()	Crashes browser on the main thread.
static org.openqa.selenium.devtools.Command<Void>	crashGpuProcess()	Crashes GPU process.
static org.openqa.selenium.devtools.Event<DownloadProgress>	downloadProgress()
static org.openqa.selenium.devtools.Event<DownloadWillBegin>	downloadWillBegin()
static org.openqa.selenium.devtools.Command<Void>	executeBrowserCommand(BrowserCommandId commandId)	Invoke custom browser commands used by telemetry.
static org.openqa.selenium.devtools.Command<List<String>>	getBrowserCommandLine()	Returns the command line switches for the browser process if, and only if --enable-automation is on the commandline.
static org.openqa.selenium.devtools.Command<Histogram>	getHistogram(String name, Optional<Boolean> delta)	Get a Chrome histogram by name.
static org.openqa.selenium.devtools.Command<List<Histogram>>	getHistograms(Optional<String> query, Optional<Boolean> delta)	Get Chrome histograms.
static org.openqa.selenium.devtools.Command<Browser.GetVersionResponse>	getVersion()	Returns version information.
static org.openqa.selenium.devtools.Command<Bounds>	getWindowBounds(WindowID windowId)	Get position and size of the browser window.
static org.openqa.selenium.devtools.Command<Browser.GetWindowForTargetResponse>	getWindowForTarget(Optional<TargetID> targetId)	Get the browser window that contains the devtools target.
static org.openqa.selenium.devtools.Command<Void>	grantPermissions(List<PermissionType> permissions, Optional<String> origin, Optional<BrowserContextID> browserContextId)	Grant specific permissions to the given origin and reject all others.
static org.openqa.selenium.devtools.Command<Void>	resetPermissions(Optional<BrowserContextID> browserContextId)	Reset all permission management for all origins.
static org.openqa.selenium.devtools.Command<Void>	setDockTile(Optional<String> badgeLabel, Optional<String> image)	Set dock tile details, platform-specific.
static org.openqa.selenium.devtools.Command<Void>	setDownloadBehavior(Browser.SetDownloadBehaviorBehavior behavior, Optional<BrowserContextID> browserContextId, Optional<String> downloadPath, Optional<Boolean> eventsEnabled)	Set the behavior when downloading a file.
static org.openqa.selenium.devtools.Command<Void>	setPermission(PermissionDescriptor permission, PermissionSetting setting, Optional<String> origin, Optional<BrowserContextID> browserContextId)	Set permission settings for given origin.
static org.openqa.selenium.devtools.Command<Void>	setWindowBounds(WindowID windowId, Bounds bounds)	Set position and/or size of the browser window.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

Browser

public Browser()

Method Details

setPermission

@Beta
public static org.openqa.selenium.devtools.Command<Void> setPermission(PermissionDescriptor permission,
 PermissionSetting setting,
 Optional<String> origin,
 Optional<BrowserContextID> browserContextId)

Set permission settings for given origin.

grantPermissions

@Beta
public static org.openqa.selenium.devtools.Command<Void> grantPermissions(List<PermissionType> permissions,
 Optional<String> origin,
 Optional<BrowserContextID> browserContextId)

Grant specific permissions to the given origin and reject all others.

resetPermissions

public static org.openqa.selenium.devtools.Command<Void> resetPermissions(Optional<BrowserContextID> browserContextId)

Reset all permission management for all origins.

setDownloadBehavior

@Beta
public static org.openqa.selenium.devtools.Command<Void> setDownloadBehavior(Browser.SetDownloadBehaviorBehavior behavior,
 Optional<BrowserContextID> browserContextId,
 Optional<String> downloadPath,
 Optional<Boolean> eventsEnabled)

Set the behavior when downloading a file.

cancelDownload

@Beta
public static org.openqa.selenium.devtools.Command<Void> cancelDownload(String guid,
 Optional<BrowserContextID> browserContextId)

Cancel a download if in progress

close

public static org.openqa.selenium.devtools.Command<Void> close()

Close browser gracefully.

crash

@Beta
public static org.openqa.selenium.devtools.Command<Void> crash()

Crashes browser on the main thread.

crashGpuProcess

@Beta
public static org.openqa.selenium.devtools.Command<Void> crashGpuProcess()

Crashes GPU process.

getVersion

public static org.openqa.selenium.devtools.Command<Browser.GetVersionResponse> getVersion()

Returns version information.

getBrowserCommandLine

@Beta
public static org.openqa.selenium.devtools.Command<List<String>> getBrowserCommandLine()

Returns the command line switches for the browser process if, and only if --enable-automation is on the commandline.

getHistograms

@Beta
public static org.openqa.selenium.devtools.Command<List<Histogram>> getHistograms(Optional<String> query,
 Optional<Boolean> delta)

Get Chrome histograms.

getHistogram

@Beta
public static org.openqa.selenium.devtools.Command<Histogram> getHistogram(String name,
 Optional<Boolean> delta)

Get a Chrome histogram by name.

getWindowBounds

@Beta
public static org.openqa.selenium.devtools.Command<Bounds> getWindowBounds(WindowID windowId)

Get position and size of the browser window.

getWindowForTarget

@Beta
public static org.openqa.selenium.devtools.Command<Browser.GetWindowForTargetResponse> getWindowForTarget(Optional<TargetID> targetId)

Get the browser window that contains the devtools target.

setWindowBounds

@Beta
public static org.openqa.selenium.devtools.Command<Void> setWindowBounds(WindowID windowId,
 Bounds bounds)

Set position and/or size of the browser window.

setDockTile

@Beta
public static org.openqa.selenium.devtools.Command<Void> setDockTile(Optional<String> badgeLabel,
 Optional<String> image)

Set dock tile details, platform-specific.

executeBrowserCommand

@Beta
public static org.openqa.selenium.devtools.Command<Void> executeBrowserCommand(BrowserCommandId commandId)

Invoke custom browser commands used by telemetry.

addPrivacySandboxEnrollmentOverride

public static org.openqa.selenium.devtools.Command<Void> addPrivacySandboxEnrollmentOverride(String url)

Allows a site to use privacy sandbox features that require enrollment without the site actually being enrolled. Only supported on page targets.

downloadWillBegin

public static org.openqa.selenium.devtools.Event<DownloadWillBegin> downloadWillBegin()

downloadProgress

public static org.openqa.selenium.devtools.Event<DownloadProgress> downloadProgress()