Skip to main content

Selenium Standalone

file

Upload a file to remote machine on which the browser is running.

Selenium Standalone command. More details can be found in the official protocol docs.

Usage
browser.file(file)
Parameters
NameTypeDetails
filestringBase64-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.

getDownloadableFiles

List files from remote machine available for download.

Selenium Standalone command. More details can be found in the official protocol docs.

Usage
browser.getDownloadableFiles()
Returns
  • <Object> names: Object containing a list of downloadable files on remote machine.

download

Download a file from remote machine on which the browser is running.

Selenium Standalone command. More details can be found in the official protocol docs.

Usage
browser.download(name)
Parameters
NameTypeDetails
namestringName of the file to be downloaded
Returns
  • <Object> data: Object containing downloaded file name and its content

deleteDownloadableFiles

Remove all downloadable files from remote machine on which the browser is running.

Selenium Standalone command. More details can be found in the official protocol docs.

Usage
browser.deleteDownloadableFiles()

getHubConfig

Receive hub config remotely.

Selenium Standalone command. More details can be found in the official protocol docs.

Usage
browser.getHubConfig()
Returns
  • <Object> config: Returns the hub config with slotCount, timeouts and other information.

gridTestSession

Get the details of the Selenium Grid node running a session.

Selenium Standalone command. More details can be found in the official protocol docs.

Usage
browser.gridTestSession(session)
Parameters
NameTypeDetails
sessionStringThe id of the session to receive hub details for.
Returns
  • <Object> details: Object containing information about session details.

gridProxyDetails

Get proxy details.

Selenium Standalone command. More details can be found in the official protocol docs.

Usage
browser.gridProxyDetails(id)
Parameters
NameTypeDetails
idstringthe id of the proxy (can be received using gridTestSession command).
Returns
  • <Object> details: Object containing information about proxy.

manageSeleniumHubLifecycle

Manage lifecycle of hub node.

Selenium Standalone command. More details can be found in the official protocol docs.

Usage
browser.manageSeleniumHubLifecycle(action)
Parameters
NameTypeDetails
actionStringCommand to call on Selenium Hub. The only implemented action is to 'shutdown' the hub.

queryGrid

Send GraphQL queries to the Selenium (hub or node) server to fetch data. (Only supported with Selenium v4 Server)

Selenium Standalone command. More details can be found in the official protocol docs.

Usage
browser.queryGrid(query)
Parameters
NameTypeDetails
querystringA GraphQL query to be send to the server.
Example
const result = await browser.queryGrid('{ nodesInfo { nodes { status, uri } } }');
console.log(JSON.stringify(result, null, 4))
/**
* outputs:
* {
* "data": {
* "nodesInfo": {
* "nodes": [{
* "status": "UP",
* "uri": "http://192.168.0.39:4444"
* }]
* }
* }
* }
*/
Returns
  • <Object> data: Result of the GraphQL query.

Welcome! How can I help?

WebdriverIO AI Copilot