Interface Browser


public interface Browser
The Browser domain defines methods and events for browser managing.
  • Method Details

    • cancelDownload

      void cancelDownload(String guid)
      Cancel a download if in progress
      Parameters:
      guid - Global unique identifier of the download.
    • cancelDownload

      void cancelDownload(String guid, String browserContextId)
      Cancel a download if in progress
      Parameters:
      guid - Global unique identifier of the download.
      browserContextId - BrowserContext to perform the action in. When omitted, default browser context is used.
    • close

      void close()
      Close browser gracefully.
    • crash

      void crash()
      Crashes browser on the main thread.
    • crashGpuProcess

      void crashGpuProcess()
      Crashes GPU process.
    • executeBrowserCommand

      void executeBrowserCommand(BrowserCommandId commandId)
      Invoke custom browser commands used by telemetry.
    • getBrowserCommandLine

      List<String> getBrowserCommandLine()
      Returns the command line switches for the browser process if, and only if --enable-automation is on the commandline.
      Returns:
      Commandline parameters
    • getHistogram

      Histogram getHistogram(String name)
      Get a Chrome histogram by name.
      Parameters:
      name - Requested histogram name.
      Returns:
      Histogram.
    • getHistogram

      Histogram getHistogram(String name, Boolean delta)
      Get a Chrome histogram by name.
      Parameters:
      name - Requested histogram name.
      delta - If true, retrieve delta since last call.
      Returns:
      Histogram.
    • getHistograms

      List<Histogram> getHistograms()
      Get Chrome histograms.
      Returns:
      Histograms.
    • getHistograms

      List<Histogram> getHistograms(String query, Boolean delta)
      Get Chrome histograms.
      Parameters:
      query - Requested substring in name. Only histograms which have query as a substring in their name are extracted. An empty or absent query returns all histograms.
      delta - If true, retrieve delta since last call.
      Returns:
      Histograms.
    • getVersion

      GetVersionResult getVersion()
      Returns version information.
      Returns:
      GetVersionResult
    • getWindowBounds

      Bounds getWindowBounds(Integer windowId)
      Get position and size of the browser window.
      Parameters:
      windowId - Browser window id.
      Returns:
      Bounds information of the window. When window state is 'minimized', the restored window position and size are returned.
    • getWindowForTarget

      GetWindowForTargetResult getWindowForTarget()
      Get the browser window that contains the devtools target.
      Returns:
      GetWindowForTargetResult
    • getWindowForTarget

      GetWindowForTargetResult getWindowForTarget(String targetId)
      Get the browser window that contains the devtools target.
      Parameters:
      targetId - Devtools agent host id. If called as a part of the session, associated targetId is used.
      Returns:
      GetWindowForTargetResult
    • grantPermissions

      void grantPermissions(PermissionType permissions)
      Grant specific permissions to the given origin and reject all others.
    • grantPermissions

      void grantPermissions(PermissionType permissions, String origin, String browserContextId)
      Grant specific permissions to the given origin and reject all others.
      Parameters:
      origin - Origin the permission applies to, all origins if not specified.
      browserContextId - BrowserContext to override permissions. When omitted, default browser context is used.
    • resetPermissions

      void resetPermissions()
      Reset all permission management for all origins.
    • resetPermissions

      void resetPermissions(String browserContextId)
      Reset all permission management for all origins.
      Parameters:
      browserContextId - BrowserContext to reset permissions. When omitted, default browser context is used.
    • setDockTile

      void setDockTile()
      Set dock tile details, platform-specific.
    • setDockTile

      void setDockTile(String badgeLabel, String image)
      Set dock tile details, platform-specific.
      Parameters:
      image - Png encoded image. (Encoded as a base64 string when passed over JSON)
    • setDownloadBehavior

      void setDownloadBehavior(DownloadBehavior behavior)
      Set the behavior when downloading a file.
      Parameters:
      behavior - Whether to allow all or deny all download requests, or use default Chrome behavior if available (otherwise deny). |allowAndName| allows download and names files according to their dowmload guids.
    • setDownloadBehavior

      void setDownloadBehavior(DownloadBehavior behavior, String browserContextId, String downloadPath, Boolean eventsEnabled)
      Set the behavior when downloading a file.
      Parameters:
      behavior - Whether to allow all or deny all download requests, or use default Chrome behavior if available (otherwise deny). |allowAndName| allows download and names files according to their dowmload guids.
      browserContextId - BrowserContext to set download behavior. When omitted, default browser context is used.
      downloadPath - The default path to save downloaded files to. This is required if behavior is set to 'allow' or 'allowAndName'.
      eventsEnabled - Whether to emit download events (defaults to false).
    • setPermission

      void setPermission(PermissionDescriptor permission, PermissionSetting setting)
      Set permission settings for given origin.
      Parameters:
      permission - Descriptor of permission to override.
      setting - Setting of the permission.
    • setPermission

      void setPermission(PermissionDescriptor permission, PermissionSetting setting, String origin, String browserContextId)
      Set permission settings for given origin.
      Parameters:
      permission - Descriptor of permission to override.
      setting - Setting of the permission.
      origin - Origin the permission applies to, all origins if not specified.
      browserContextId - Context to override. When omitted, default browser context is used.
    • setWindowBounds

      void setWindowBounds(Integer windowId, Bounds bounds)
      Set position and/or size of the browser window.
      Parameters:
      windowId - Browser window id.
      bounds - New window bounds. The 'minimized', 'maximized' and 'fullscreen' states cannot be combined with 'left', 'top', 'width' or 'height'. Leaves unspecified fields unchanged.