Package org.openqa.selenium.devtools.v112.browser

Class Browser

  • public class Browser
extends java.lang.Object
    The Browser domain defines methods and events for browser managing.

    • Constructor Summary

      Constructors 
      Constructor Description
      Browser()  

    • Method Summary

      All Methods Static Methods Concrete Methods 
      Modifier and Type Method Description
      static org.openqa.selenium.devtools.Command<java.lang.Void> cancelDownload​(java.lang.String guid, java.util.Optional<BrowserContextID> browserContextId)
      Cancel a download if in progress
      static org.openqa.selenium.devtools.Command<java.lang.Void> close()
      Close browser gracefully.
      static org.openqa.selenium.devtools.Command<java.lang.Void> crash()
      Crashes browser on the main thread.
      static org.openqa.selenium.devtools.Command<java.lang.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<java.lang.Void> executeBrowserCommand​(BrowserCommandId commandId)
      Invoke custom browser commands used by telemetry.
      static org.openqa.selenium.devtools.Command<java.util.List<java.lang.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​(java.lang.String name, java.util.Optional<java.lang.Boolean> delta)
      Get a Chrome histogram by name.
      static org.openqa.selenium.devtools.Command<java.util.List<Histogram>> getHistograms​(java.util.Optional<java.lang.String> query, java.util.Optional<java.lang.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​(java.util.Optional<TargetID> targetId)
      Get the browser window that contains the devtools target.
      static org.openqa.selenium.devtools.Command<java.lang.Void> grantPermissions​(java.util.List<PermissionType> permissions, java.util.Optional<java.lang.String> origin, java.util.Optional<BrowserContextID> browserContextId)
      Grant specific permissions to the given origin and reject all others.
      static org.openqa.selenium.devtools.Command<java.lang.Void> resetPermissions​(java.util.Optional<BrowserContextID> browserContextId)
      Reset all permission management for all origins.
      static org.openqa.selenium.devtools.Command<java.lang.Void> setDockTile​(java.util.Optional<java.lang.String> badgeLabel, java.util.Optional<java.lang.String> image)
      Set dock tile details, platform-specific.
      static org.openqa.selenium.devtools.Command<java.lang.Void> setDownloadBehavior​(Browser.SetDownloadBehaviorBehavior behavior, java.util.Optional<BrowserContextID> browserContextId, java.util.Optional<java.lang.String> downloadPath, java.util.Optional<java.lang.Boolean> eventsEnabled)
      Set the behavior when downloading a file.
      static org.openqa.selenium.devtools.Command<java.lang.Void> setPermission​(PermissionDescriptor permission, PermissionSetting setting, java.util.Optional<java.lang.String> origin, java.util.Optional<BrowserContextID> browserContextId)
      Set permission settings for given origin.
      static org.openqa.selenium.devtools.Command<java.lang.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 Detail

      • Browser

        public Browser()

    • Method Detail

      • setPermission

        @Beta
public static org.openqa.selenium.devtools.Command<java.lang.Void> setPermission​(PermissionDescriptor permission,
                                                                                 PermissionSetting setting,
                                                                                 java.util.Optional<java.lang.String> origin,
                                                                                 java.util.Optional<BrowserContextID> browserContextId)
        Set permission settings for given origin.

      • grantPermissions

        @Beta
public static org.openqa.selenium.devtools.Command<java.lang.Void> grantPermissions​(java.util.List<PermissionType> permissions,
                                                                                    java.util.Optional<java.lang.String> origin,
                                                                                    java.util.Optional<BrowserContextID> browserContextId)
        Grant specific permissions to the given origin and reject all others.

      • resetPermissions

        @Beta
public static org.openqa.selenium.devtools.Command<java.lang.Void> resetPermissions​(java.util.Optional<BrowserContextID> browserContextId)
        Reset all permission management for all origins.

      • setDownloadBehavior

        @Beta
public static org.openqa.selenium.devtools.Command<java.lang.Void> setDownloadBehavior​(Browser.SetDownloadBehaviorBehavior behavior,
                                                                                       java.util.Optional<BrowserContextID> browserContextId,
                                                                                       java.util.Optional<java.lang.String> downloadPath,
                                                                                       java.util.Optional<java.lang.Boolean> eventsEnabled)
        Set the behavior when downloading a file.

      • cancelDownload

        @Beta
public static org.openqa.selenium.devtools.Command<java.lang.Void> cancelDownload​(java.lang.String guid,
                                                                                  java.util.Optional<BrowserContextID> browserContextId)
        Cancel a download if in progress

      • close

        public static org.openqa.selenium.devtools.Command<java.lang.Void> close()
        Close browser gracefully.

      • crash

        @Beta
public static org.openqa.selenium.devtools.Command<java.lang.Void> crash()
        Crashes browser on the main thread.

      • crashGpuProcess

        @Beta
public static org.openqa.selenium.devtools.Command<java.lang.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<java.util.List<java.lang.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<java.util.List<Histogram>> getHistograms​(java.util.Optional<java.lang.String> query,
                                                                                            java.util.Optional<java.lang.Boolean> delta)
        Get Chrome histograms.

      • getHistogram

        @Beta
public static org.openqa.selenium.devtools.Command<Histogram> getHistogram​(java.lang.String name,
                                                                           java.util.Optional<java.lang.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​(java.util.Optional<TargetID> targetId)
        Get the browser window that contains the devtools target.

      • setWindowBounds

        @Beta
public static org.openqa.selenium.devtools.Command<java.lang.Void> setWindowBounds​(WindowID windowId,
                                                                                   Bounds bounds)
        Set position and/or size of the browser window.

      • setDockTile

        @Beta
public static org.openqa.selenium.devtools.Command<java.lang.Void> setDockTile​(java.util.Optional<java.lang.String> badgeLabel,
                                                                               java.util.Optional<java.lang.String> image)
        Set dock tile details, platform-specific.

      • executeBrowserCommand

        @Beta
public static org.openqa.selenium.devtools.Command<java.lang.Void> executeBrowserCommand​(BrowserCommandId commandId)
        Invoke custom browser commands used by telemetry.

      • downloadWillBegin

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

      • downloadProgress

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