Chromium
#
isAlertOpenWhether a simple dialog is currently open.
Non official and undocumented Chromium command. More about this command can be found here.
#
Usage#
Example#
Returns- <Boolean> isAlertOpen:
true
orfalse
based on whether simple dialog is present or not.
#
isAutoReportingWhether it should automatically raises errors on browser logs.
Non official and undocumented Chromium command. More about this command can be found here.
#
Usage#
Returns- <Boolean> isAutoReporting:
true
orfalse
based on whether auto reporting is enabled.
#
setAutoReportingToggle whether to return response with unknown error with first browser error (e.g. failed to load resource due to 403/404 response) for all subsequent commands (once enabled).
Non official and undocumented Chromium command. More about this command can be found here.
#
Usage#
ParametersName | Type | Details |
---|---|---|
enabled | boolean | true if auto reporting should be enabled, use false to disable previously enabled auto reporting. |
#
Examples#
Returns- <Object|Null> firstBrowserError: In case first browser error already occured prior to executing this command it will throw unknown error as response, which is an object with 'message' key describing first browser error. Otherwise it returns
null
on success.
#
isLoadingDetermines load status for active window handle.
Non official and undocumented Chromium command. More about this command can be found here.
#
Usage#
Example#
Returns- <Boolean> isLoading:
true
orfalse
based on whether active window handle is loading or not.
#
takeHeapSnapshotTakes a heap snapshot of the current execution context.
Non official and undocumented Chromium command. More about this command can be found here.
#
Usage#
Returns- <Object> heapSnapshot: A JSON representation of the heap snapshot. Which can be inspected by loading as file into Chrome DevTools.
#
getNetworkConnectionGet the connection type for network emulation. This command is only applicable when remote end replies with networkConnectionEnabled
capability set to true
.
Non official and undocumented Chromium command. More about this command can be found here.
#
Usage#
Example#
Returns- <Number> connectionType: A bitmask to represent the network connection type. Airplane Mode (
1
), Wi-Fi only (2
), Wi-Fi and data (6
), 4G (8
), 3G (10
), 2G (20
). By default Wi-Fi and data are enabled.
#
setNetworkConnectionChange connection type for network connection. This command is only applicable when remote end replies with networkConnectionEnabled
capability set to true
.
Non official and undocumented Chromium command. More about this command can be found here.
#
Usage#
ParametersName | Type | Details |
---|---|---|
parameters | object | Object containing ConnectionType, set bitmask as value for type key in object. Airplane Mode (1 ), Wi-Fi only (2 ), Wi-Fi and data (6 ), 4G (8 ), 3G (10 ), 2G (20 ). |
#
Example#
Returns- <Number> connectionType: A bitmask to represent the network connection type. Value should match specified
type
in object, however device might not be capable of the network connection type requested.
#
getNetworkConditionsGet current network conditions used for emulation.
Non official and undocumented Chromium command. More about this command can be found here.
#
Usage#
Returns- <Object> networkConditions: Object containing network conditions for
offline
,latency
,download_throughput
andupload_throughput
. Network conditions must be set before it can be retrieved.
#
setNetworkConditionsSet network conditions used for emulation by throttling connection.
Non official and undocumented Chromium command. More about this command can be found here.
#
Usage#
ParametersName | Type | Details |
---|---|---|
network_conditions | object | Object containing network conditions which are latency , throughput (or download_throughput /upload_throughput ) and offline (optional). |
network_name optional | string | Name of network throttling preset. GPRS , Regular 2G , Good 2G , Regular 3G , Good 3G , Regular 4G , DSL , WiFi or No throttling to disable. When preset is specified values passed in first argument are not respected. |
#
Examples#
deleteNetworkConditionsDisable any network throttling which might have been set. Equivalent of setting the No throttling
preset.
Non official and undocumented Chromium command. More about this command can be found here.
#
Usage#
sendCommandSend a command to the DevTools debugger.
For a list of available commands and their parameters refer to the Chrome DevTools Protocol Viewer.
Non official and undocumented Chromium command. More about this command can be found here.
#
Usage#
ParametersName | Type | Details |
---|---|---|
cmd | string | Name of the command (e.g. Browser.close ). |
params | object | Parameters to the command. In case no parameters for command, specify an empty object. |
#
sendCommandAndGetResultSend a command to the DevTools debugger and wait for the result.
For a list of available commands and their parameters refer to the Chrome DevTools Protocol Viewer.
Non official and undocumented Chromium command. More about this command can be found here.
#
Usage#
ParametersName | Type | Details |
---|---|---|
cmd | string | Name of the command which returns a result (e.g. Network.getAllCookies ). |
params | object | Parameters to the command. In case no parameters for command, specify an empty object. |
#
Returns- <*> result: Either the return value of your command, or the error which was the reason for your command's failure.
#
fileUpload a file to remote machine on which the browser is running.
Non official and undocumented Chromium command. More about this command can be found here.
#
Usage#
ParametersName | Type | Details |
---|---|---|
file | string | Base64-encoded zip archive containing single file which to upload. In case base64-encoded data does not represent a zip archive or archive contains more than one file it will throw an unknown error. |
#
Returns- <String> path: Absolute path of uploaded file on remote machine.
#
launchChromeAppLaunches a Chrome app by specified id.
Non official and undocumented Chromium command. More about this command can be found here.
#
Usage#
ParametersName | Type | Details |
---|---|---|
id | string | Extension id of app to be launched, as defined in chrome://extensions. |
#
Example#
getElementValueRetrieves the value of a given form control element.
Non official and undocumented Chromium command. More about this command can be found here.
#
Usage#
ParametersName | Type | Details |
---|---|---|
elementId | String | id of element to get value from |
#
Returns- <String|Null> value: Current value of the element. In case specified element is not a form control element, it will return
null
.
#
elementHoverEnable hover state for an element, which is reset upon next interaction.
Non official and undocumented Chromium command. More about this command can be found here.
#
Usage#
ParametersName | Type | Details |
---|---|---|
elementId | String | id of element to hover over to |
#
touchPinchTrigger a pinch zoom effect.
Non official and undocumented Chromium command. More about this command can be found here.
#
Usage#
ParametersName | Type | Details |
---|---|---|
x | number | x position to pinch on |
y | number | y position to pinch on |
scale | number | pinch zoom scale |
#
freezeFreeze the current page. Extension for Page Lifecycle API.
Non official and undocumented Chromium command. More about this command can be found here.
#
Usage#
resumeResume the current page. Extension for Page Lifecycle API.
Non official and undocumented Chromium command. More about this command can be found here.
#
Usage#
shutdownShutdown ChromeDriver process and consequently terminating all active sessions.
Non official and undocumented Chromium command. More about this command can be found here.
#
Usage#
takeElementScreenshotThe Take Element Screenshot command takes a screenshot of the visible region encompassed by the bounding rectangle of an element.
Non official and undocumented Chromium command. More about this command can be found here.
#
Usage#
ParametersName | Type | Details |
---|---|---|
elementId | String | the id of an element returned in a previous call to Find Element(s) |
scroll optional | boolean | scroll into view the element. Default: true |
#
Returns- <String> screenshot: The base64-encoded PNG image data comprising the screenshot of the visible region of an element’s bounding rectangle after it has been scrolled into view.
#
getLogTypesGet available log types.
Non official and undocumented Chromium command. More about this command can be found here.
#
Usage#
Returns- <String[]> logTypes: The list of available log types, example: browser, driver.
#
getLogsGet the log for a given log type. Log buffer is reset after each request.
Non official and undocumented Chromium command. More about this command can be found here.
#
Usage#
ParametersName | Type | Details |
---|---|---|
type | string | the log type |
#
Returns- <Object[]> logs: The list of log entries.