Selenium 独立版

文件

将文件上传到运行浏览器的远程机器。

Selenium 独立版命令。更多详细信息可以在官方协议文档中找到。

用法

browser.file(file)

参数

名称	类型	详情
文件	字符串	包含要上传的**单个**文件的 Base64 编码的 zip 存档。如果 Base64 编码的数据不表示 zip 存档或存档包含多个文件，则会抛出一个未知错误。

返回值

• <字符串> 路径: 远程机器上上传文件的绝对路径。

---

getDownloadableFiles

列出远程机器上可供下载的文件。

Selenium 独立版命令。更多详细信息可以在官方协议文档中找到。

用法

browser.getDownloadableFiles()

返回值

• <对象> 名称: 包含远程机器上可下载文件列表的对象。

---

下载

从运行浏览器的远程机器下载文件。

Selenium 独立版命令。更多详细信息可以在官方协议文档中找到。

用法

browser.download(name)

参数

名称	类型	详情
名称	字符串	要下载的文件的名称

返回值

• <对象> 数据: 包含下载的文件名及其内容的对象

---

deleteDownloadableFiles

删除运行浏览器的远程机器上的所有可下载文件。

Selenium 独立版命令。更多详细信息可以在官方协议文档中找到。

用法

browser.deleteDownloadableFiles()

---

getHubConfig

远程接收集线器配置。

Selenium 独立版命令。更多详细信息可以在官方协议文档中找到。

用法

browser.getHubConfig()

返回值

• <对象> 配置: 返回包含 slotCount、超时和其他信息的集线器配置。

---

gridTestSession

获取运行会话的 Selenium Grid 节点的详细信息。

Selenium 独立版命令。更多详细信息可以在官方协议文档中找到。

用法

browser.gridTestSession(session)

参数

名称	类型	详情
会话	字符串	要接收集线器详细信息的会话 ID。

返回值

• <对象> 详细信息: 包含有关会话详细信息的信息的对象。

---

gridProxyDetails

获取代理详细信息。

Selenium 独立版命令。更多详细信息可以在官方协议文档中找到。

用法

browser.gridProxyDetails(id)

参数

名称	类型	详情
ID	字符串	代理的 ID（可以使用 gridTestSession 命令接收）。

返回值

• <对象> 详细信息: 包含有关代理的信息的对象。

---

manageSeleniumHubLifecycle

管理集线器节点的生命周期。

Selenium 独立版命令。更多详细信息可以在官方协议文档中找到。

用法

browser.manageSeleniumHubLifecycle(action)

参数

名称	类型	详情
操作	字符串	在 Selenium 集线器上调用的命令。唯一实现的操作是“关闭”集线器。

---

queryGrid

向 Selenium（集线器或节点）服务器发送 GraphQL 查询以获取数据。（仅支持 Selenium v4 服务器）

Selenium 独立版命令。更多详细信息可以在官方协议文档中找到。

用法

browser.queryGrid(query)

参数

名称	类型	详情
查询	字符串	要发送到服务器的 GraphQL 查询。

示例

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"
 *       }]
 *     }
 *   }
 * }
 */

返回值

• <对象> 数据: GraphQL 查询的结果。